从 502 到 200 OK:我把「AI 软件工厂」强行焊在了云端

完整记录把 avanda-vibe(原 bolt.diy)从群晖 NAS 搬到云服务器的全过程:502 死循环、EPIPE 内核不兼容、localhost 监听锁死,最后用生产构建 + 0.0.0.0 监听点亮了它,并附三条可落地的变现路径。

文章目录

写在前面:如果你还在为配置 Python 环境、折腾 Node 版本、在各种 npm install 的报错里怀疑人生,请先停下这种自虐行为。

这篇记录的是我把自己的 Avanda Vibe 从「本地项目」搬到「公网可用」的完整过程。中间死了三次,最后一次才真的点亮了。


01. 震撼:开发变成了「聊天」

01. 震撼:开发变成了「聊天」(AI 生成示意图)

01. 震撼:开发变成了「聊天」 · AI 生成示意图

第一次打开 avanda-vibe(开源项目 bolt.diy 的自建版本)时,我整个人是震住的。

传统的开发链路是这样的:

构思 → 搭环境 → 写代码 → 跑起来 → 报错 → 搜 → 改 → 重启

而在 avanda-vibe 里,这一条链路被压缩成了:

对话 → 代码在屏幕上自动跳动 → 右侧预览实时出画面 → 不满意就再说一句

它内置了 WebContainer 模拟器,等于把一台微型 Linux 服务器塞进了浏览器。你不用在本地装任何东西,AI 直接在容器里把全栈项目给你搓出来、跑起来。

这不是效率的线性提升,是量级变化。 以前验证一个想法要两天开发,现在一杯咖啡的时间就能拿到能跑的原型。

我当时的判断很直接:这东西如果部署成功,它就是一台「AI 软件工厂」。而我想要的是把它放在自己的服务器上,对外提供一个中文的、能直接用的入口——于是接下来这十个小时,就成了我跟自己较劲的过程。


02. 挫败一:群晖 NAS 上的 502 死循环

02. 挫败一:群晖 NAS 上的 502 死循环(AI 生成示意图)

02. 挫败一:群晖 NAS 上的 502 死循环 · AI 生成示意图

第一步当然是从家里 NAS 开始。我的 NAS 是群晖,Docker 一把梭:

services:
  app-dev:
    image: avanda-vibe:latest
    ports:
      - "5173:5173"

容器起来了,docker ps 显示 Up,端口也映射了,宿主机上 netstat 明确能看到 0.0.0.0:5173 LISTEN。

然后打开浏览器——502 Bad Gateway。

第一次以为是启动没等够,等了两分钟,还是 502。重启容器,还是 502。删镜像重拉,还是 502。

我开始怀疑 Cloudflare 隧道,但隧道的日志显示它连的是宿主机端口,宿主机端口是通的。那问题只能在容器里。

于是我钻进容器看日志:

> remix vite:dev "--host"
  ➜  Local:   http://localhost:5173/
  ➜  Network: http://172.25.0.2:5173/

看到没?它打印的是 localhost:5173。

Vite 的 --host 本意是监听 0.0.0.0,但这个项目的启动脚本是 remix vite:dev "--host"——--host 被当成字符串参数塞进去了,没有真正传值,所以实际绑定的还是 127.0.0.1。Docker 的端口映射只能转发到容器网卡上真实监听的地址,服务压根没在那儿监听,外面怎么转发都是空的。

我试过在 package.json 里改成 remix vite:dev --host 0.0.0.0,也试过在 compose 里加 HOST=0.0.0.0、VITE_HOST=0.0.0.0 环境变量——日志里的 Local: 纹丝不动。

最后一招,我直接去内核层面看证据:

docker exec avanda-vibe_app-dev_1 sh -c "cat /proc/net/tcp"

出来的每一行 local_address 都是 0100007F 开头的,也就是 127.0.0.1,一个 00000000(0.0.0.0)都没有。实锤了:它只肯在自己家里开门。


03. 挫败二:NAS 上连「编译」这一步都过不去

按理说,把监听地址修好、重新构建镜像、传上去就行了。但我在 NAS 上执行构建时撞上了第二堵墙:

Error: write EPIPE
    at Runtime.updateConfig (.../miniflare/src/runtime/index.ts:154:24)
    at Miniflare2.#assembleAndUpdateConfig (...)

miniflare 是 Cloudflare Workers 的本地模拟器,而它的底座是一个叫 workerd 的原生二进制。bolt.diy 的 vite.config.ts 里挂了 cloudflare 的 proxy 插件,每次 build 和 dev 都会拉起 workerd。

而群晖为了稳定性裁剪过的内核,跟 workerd 要求的系统调用对不上。workerd 一启动就死,Node 往它写配置就得到 EPIPE。

我当时试着绕过构建,直接在宿主机跑 dev:

Remix Vite plugin not found in Vite config

——没有容器的环境变量和路径映射,插件链又找不到。这个项目对环境的耦合比我想象中高得多。


04. 转折:别在不行的地方死磕

到这一步我停下来算了笔账:

  • NAS:内核不合,连编译都做不到。
  • Mac:Docker Desktop 有完整虚拟化,workerd 能跑。
  • 云服务器:标准 Ubuntu 内核,编译能过。

所以结论很明确:编译在能跑的地方做,运行也放在能跑的地方。 生产构建才是正解——dev 模式是给开发者本地调试用的,里面挂着 workerd 代理;生产模式是编译后的产物,不依赖那套东西。

我先在 Mac 上用 --platform linux/amd64 构建镜像再传回 NAS,结果镜像在 NAS 上起来后仍然监听 127.0.0.1——因为宿主机的端口映射根本不是解法,解法是让服务自己监听 0.0.0.0。

最终方案:把整个项目搬到一台 Ubuntu 22.04 的云服务器上。


05. 点亮:HTTP 200 OK

云服务器上就很朴素了:

curl -fsSL https://get.pnpm.io/install.sh | sh -
git clone --depth 1 https://github.com/tyrellshawn/bolt.diy.git .
pnpm install
pnpm run build          # 这次没有 EPIPE,workerd 在标准内核上跑得动
pnpm run start -- --host 0.0.0.0

监听地址这次是对的,日志里不再是 localhost,服务对外可达。

至于中文,简单粗暴但有效:

sed -i 's/How can Bolt help you today\?/今天 Bolt 能为您提供什么帮助\?/g' app/components/chat/BaseChat.tsx
sed -i 's/Settings/设置/g' app/components/settings/SettingsWindow.tsx
sed -i 's/API Key/API 密钥/g' app/components/settings/SettingsWindow.tsx
sed -i 's/Bolt.diy/Avanda Vibe/g' app/components/header/Header.tsx

改完重新 build,刷新页面——欢迎词变成了「今天 Bolt 能为您提供什么帮助?」。

那一刻的感觉怎么说呢,就像黑了一晚上的屏幕突然亮了。从 502 到 200 OK,中间隔着的不是技术难度,是愿不愿意承认「这条路走不通,换一条」。


06. 这东西到底能干什么:三条变现路径

部署完我盯着这个界面想了一会儿:它真正的价值不是「写代码快」,而是把「一个想法变成能点开的网页」的边际成本压到了接近零。基于这一点,有三条我觉得跑得通的变现路径:

① 极速 MVP 验证 以前验证一个创业方向要两周开发,现在两小时。低成本意味着可以一天试十个方向,而不是赌对一个。

② 低成本软件定制 中小企业想做个小工具、内部系统、落地页,老办法是找外包团队按周报价。现在是一个懂提示词的人加一台 avanda-vibe,当场出原型当场交付,报价空间完全是另一个量级。

③ 会员增值 对不想折腾环境的人,「开箱即用的中文 AI 编程工作台」本身就是服务。把它做成会员权益,比单卖工具更有黏性。

谁能掌握这台「工厂」,谁就掌握了定义软件的权力。


🚀 现在就能用

我把上面这一套全部装好了,中文界面、生产构建、公网可访问:

👉 avandaai.com/vibe

你可以直接丢一句话给它,让它做一个能跑的小应用试试手感。

这里不聊虚的,只聊怎么死磕、怎么点亮、怎么起飞。


踩坑记录:502 不一定是端口没映射,也可能是进程只监听了 127.0.0.1;EPIPE 不一定是网络问题,也可能是原生依赖跟内核不合。遇到这种玄学,先去看 /proc/net/tcp 和容器日志,比瞎改配置快十倍。

文中链接

整理自本文的外部链接,请以来源页面说明为准。

从 502 到 200 OK:我把「AI 软件工厂」强行焊在了云端 · 阿凡达博客