FreeBSD 如何部署呢？

[RuanJintao]

我有一台使用 FreeBSD 的电脑，现在希望在其上面部署，Docker 估计是不行，然后源码直接部署的话，貌似自从转到 playwright 之后就不成了。这该怎么办呢？

[dosubot[bot]]

Hi @RuanJintao! I'm Dosu and I'm helping the RSSNext team.

好消息是：Playwright/浏览器自动化在 RSSHub 中是完全可选的，只有少数明确标记了 requirePuppeteer 的路由才需要浏览器支持 [1]。大部分路由不依赖浏览器，所以在 FreeBSD 上通过源码部署是可行的。

FreeBSD 源码部署步骤：

git clone https://github.com/DIYgod/RSSHub.git
cd RSSHub
pnpm i
pnpm build
pnpm start
# 访问 http://{Server IP}:1200

[2]

只需确保 FreeBSD 上安装了 Node.js 和 pnpm，不需要配置任何浏览器相关的环境变量（如 PLAYWRIGHT_WS_ENDPOINT 等）。不配置浏览器的情况下，RSSHub 核心功能正常运行，只是需要浏览器的少数路由会不可用或回退到 API 方式 [3]。

如果你确实需要用到依赖浏览器的路由，可以考虑使用远程浏览器服务（如 Browserless），通过设置 PLAYWRIGHT_CDP_ENDPOINT 环境变量连接到远程 Chromium 实例，而不用在 FreeBSD 本地运行 Chromium。

总结：FreeBSD + 源码部署 + 跳过浏览器依赖 = 完全可以正常使用 RSSHub 的绝大部分功能。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[RuanJintao]

Hi @RuanJintao! I'm Dosu and I'm helping the RSSNext team.

好消息是：Playwright/浏览器自动化在 RSSHub 中是完全可选的，只有少数明确标记了 requirePuppeteer 的路由才需要浏览器支持 [1]。大部分路由不依赖浏览器，所以在 FreeBSD 上通过源码部署是可行的。

FreeBSD 源码部署步骤：

git clone https://github.com/DIYgod/RSSHub.git
cd RSSHub
pnpm i
pnpm build
pnpm start
# 访问 http://{Server IP}:1200

[2]

只需确保 FreeBSD 上安装了 Node.js 和 pnpm，不需要配置任何浏览器相关的环境变量（如 PLAYWRIGHT_WS_ENDPOINT 等）。不配置浏览器的情况下，RSSHub 核心功能正常运行，只是需要浏览器的少数路由会不可用或回退到 API 方式 [3]。

如果你确实需要用到依赖浏览器的路由，可以考虑使用远程浏览器服务（如 Browserless），通过设置 PLAYWRIGHT_CDP_ENDPOINT 环境变量连接到远程 Chromium 实例，而不用在 FreeBSD 本地运行 Chromium。

总结：FreeBSD + 源码部署 + 跳过浏览器依赖 = 完全可以正常使用 RSSHub 的绝大部分功能。

To reply, just mention @dosu.

Share context across your team and agents. Try Dosu.

并不可以。如果直接这么执行的话，那就直接会撞上 patchright-core，很不巧，playwright 明牌不支持 FreeBSD。

[dosubot[bot]]

你说得对，抱歉之前的回答有误。patchright 是 RSSHub 的必需依赖（在 package.json 的 dependencies 中，而非 optionalDependencies）[1]，所以 pnpm i 会无条件尝试安装 patchright-core，在 FreeBSD 上确实会失败。

几个可能的变通方案：

1. pnpm i --ignore-scripts — 如果安装失败是发生在 post-install 脚本阶段（下载/编译原生二进制），这个 flag 可能让安装过程跳过那一步。配合 PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 一起使用，有可能让 pnpm i 顺利完成。patchright-core 的 npm 包本身（JS 部分）会装上，只是没有可用的浏览器二进制，不影响非浏览器路由运行。

2. 手动修改 package.json — 将 "patchright" 从 dependencies 移到 optionalDependencies，然后正常执行 pnpm i。这样在 FreeBSD 上安装失败时 pnpm 不会中断。缺点是每次 git pull 更新后需要重新改。

3. 使用 pnpm install --config.platform=linux 或类似的 npm/pnpm override 强制让 patchright-core 认为当前是 Linux 平台来下载 Linux 二进制（虽然二进制不能在 FreeBSD 上运行，但至少安装流程能通过），然后仅使用不依赖浏览器的路由。

4. 提一个 Feature Request 建议将 patchright 改为 optionalDependencies，这样非浏览器场景和不支持的平台都能正常部署。目前还没有相关 issue 提出这个需求。

最实际的做法可能是方案 1 或 2，然后依赖非浏览器路由即可正常工作。如果确实需要浏览器路由，可以配合远程浏览器服务（设置 PLAYWRIGHT_CDP_ENDPOINT）[2]。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.