企业官网建设流程全解析

1. 手机连服务器跑 Agent，卡在哪一步

opencode 是一个跑在终端里的 AI 编码 Agent，能读文件、改代码、执行命令。它自带opencode web模式，会在服务器上起一个 Web 服务，理论上你拿手机浏览器就能远程指挥服务器上的 Agent 干活。但真到 Linux 服务器上部署，问题会集中爆发在三个地方：服务默认只监听 localhost，手机根本连不上；公网隧道起来后，opencode 的模型请求没有统一出口，Key 散落在环境变量里；手机端登录后 Agent 一执行任务就报鉴权失败，因为隧道转发和 API 通道是两套东西。

这篇聚焦的场景很具体：一台远程 Linux 服务器，上面跑 opencode web，通过 cloudflared 隧道暴露到公网，你用手机浏览器访问，让服务器上的 Agent 执行任务。核心要解决的是统一鉴权与配置——把模型调用收敛到 TaoToken 的 API 通道，把隧道配置和 opencode 的 config.toml 骨架固定下来，让整条链路可复制、可验证。适合已经在用 opencode、想摆脱本地电脑和 VS Code 端口转发的人，也适合想把 Agent 放到服务器上长期跑、手机随时接管的人。

我试过在 ARM 服务器上从零搭这套链路，踩过的坑主要集中在 cloudflared 架构选错、opencode 监听地址没改、以及模型 Key 没走统一通道导致手机端请求 401。下面按可跟做的顺序拆开。

2. TaoToken 前置：统一 Key 与 API 通道

opencode 支持自定义模型提供商，配置写在~/.config/opencode/config.toml或项目级opencode.toml里。远程调试场景下，服务器上的 Agent 要调模型，手机端只是通过浏览器操作这个 Agent，所以模型请求实际是从服务器发出的。这时候把 Key 和 Base URL 统一到 TaoToken，好处是：一个 Key 管所有模型，换模型不用改代码，隧道这头只管转发 Web 流量，不碰模型鉴权。

TaoToken 的 API 入口是https://taotoken.net/api，兼容 OpenAI 风格的/v1/chat/completions和 Anthropic 风格的/v1/messages。opencode 里配置 provider 时，Base URL 填这个，Key 填你在控制台生成的。如果你用的是 Claude Code 那套 Anthropic 协议，opencode 也支持，走的是同一个 API 域名下的 Anthropic 兼容路径。

先去控制台拿 Key：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=console

拿完 Key 别急着写进 config，先确认服务器能通。在服务器上跑一条 curl，验证 API 通道本身没问题：

curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" | head -c 500

返回模型列表 JSON 就说明通道通。这一步很重要，因为后面手机端报错时，你要能区分是隧道问题还是 API 问题。如果这条 curl 就失败，先解决服务器出网和 Key 的问题，别往下走。

3. 可复制配置：config.toml 骨架 + cloudflared 隧道

3.1 opencode 的 config.toml 骨架

在服务器上创建或编辑~/.config/opencode/config.toml。下面这份骨架把 TaoToken 作为统一 provider，模型名按你实际用的填：

# ~/.config/opencode/config.toml model = "taotoken/claude-sonnet-4-5" small_model = "taotoken/claude-haiku-4-5" [provider.taotoken] name = "TaoToken" baseURL = "https://taotoken.net/api" apiKey = "{env:TAOTOKEN_API_KEY}" [provider.taotoken.models.claude-sonnet-4-5] name = "Claude Sonnet 4.5" [provider.taotoken.models.claude-haiku-4-5] name = "Claude Haiku 4.5"

关键点：apiKey用{env:TAOTOKEN_API_KEY}引用环境变量，不要把 Key 硬编码进文件。然后在服务器的 shell 配置里导出：

echo 'export TAOTOKEN_API_KEY="sk-你的key"' >> ~/.bashrc source ~/.bashrc

如果你更习惯用 Anthropic 协议直连，opencode 也支持provider里指定type = "anthropic"，Base URL 同样指向 TaoToken 的 API 域名。两种方式选一种即可，别混用。

3.2 cloudflared 安装与隧道启动

先确认服务器架构：

uname -m

x86_64对应 amd64，aarch64对应 arm64。下载对应二进制后赋权、放进 PATH：

chmod +x cloudflared-linux-amd64 sudo mv cloudflared-linux-amd64 /usr/local/bin/cloudflared cloudflared --version

启动 opencode web，注意监听地址必须是0.0.0.0，否则隧道转发不到：

OPENCODE_SERVER_PASSWORD='你的强密码' \ opencode web --hostname 0.0.0.0 --port 4096

另开一个 SSH 窗口，启动隧道：

cloudflared tunnel --url http://localhost:4096

终端会输出一个https://xxx.trycloudflare.com地址，复制它。两个窗口都不能关，opencode 进程和隧道进程要同时活着。

注意：trycloudflare.com是临时隧道，重启后地址会变。长期用建议在 Cloudflare 后台建命名隧道，配置写进~/.cloudflared/config.yml，这里不展开。

4. 验证请求：手机端 opencode web 实测

手机浏览器打开隧道地址，会弹出登录框。用户名固定是opencode，密码是你启动时设的OPENCODE_SERVER_PASSWORD。登录后进入 opencode web 界面，新建一个会话，让它执行一个简单任务，比如「列出当前目录下的文件并统计数量」。

Agent 执行时，模型请求从服务器发出，走的是 config.toml 里配的 TaoToken 通道。如果配置正确，你会看到 Agent 正常返回结果。验证 API 通道是否真的被调用，可以在服务器上另开窗口看 opencode 的日志，或者直接再跑一次 curl 确认 Key 有效：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-haiku-4-5","messages":[{"role":"user","content":"ping"}],"max_tokens":10}'

返回带choices的 JSON 就说明模型通道正常。手机端能正常对话、Agent 能执行文件操作，整条链路就算通了。

如果你想让手机端直接和模型对话做验证，不经过 Agent，可以用模型对话入口：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=models

5. 本篇常见错排查

手机打开隧道地址显示 502 或超时：先确认 opencode web 进程还活着，且监听的是0.0.0.0而不是127.0.0.1。用ss -tlnp | grep 4096看监听地址。如果只监听 localhost，隧道转发会失败。

登录后 Agent 执行任务报 401 或鉴权失败：这是模型通道的问题，不是隧道的问题。检查TAOTOKEN_API_KEY是否在当前 shell 生效，echo $TAOTOKEN_API_KEY看有没有值。config.toml 里如果写死了旧 Key，改掉。另外确认 Base URL 是https://taotoken.net/api，不要多加/v1，opencode 会自己拼路径。

cloudflared 启动报架构不匹配：uname -m的输出和下载的二进制对不上。aarch64 必须用 arm64 版本，x86_64 用 amd64 版本。重新下载对应文件。

隧道地址每次重启都变：临时隧道就是这样。要固定地址，去 Cloudflare 后台创建命名隧道，把 tunnel ID 和 credentials 文件配好，用cloudflared tunnel run <name>启动。

手机端界面能打开但 Agent 不执行命令：opencode 的 Agent 执行命令依赖服务器上的 shell 环境。确认服务器上bash可用，且 opencode 进程有权限读写工作目录。如果工作目录是/root下的项目，注意权限。

API 请求超时但 curl 正常：可能是 opencode 的 provider 配置里 baseURL 写错，或者模型名和 TaoToken 支持的名称不一致。用/v1/models接口确认可用模型名，再回填 config.toml。

6. 长期跑 Agent 的配置建议

如果你打算让这套链路长期跑，而不是临时调试，建议把模型调用收敛到 Coding Plan，这样多模型切换和额度管理都在一个地方，不用每次改 config.toml。Coding Plan 入口：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=coding_plan

接入文档里有 opencode、Claude Code 等工具的完整配置示例，遇到 provider 字段不确定时直接对照：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc

API Keys 管理页可以随时轮换 Key，轮换后只需更新服务器上的环境变量，config.toml 不用动：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=api_keys

最后一步实操建议：把 opencode web 和 cloudflared 用 systemd 或 tmux 托管，别依赖 SSH 窗口。tmux 最简单：

tmux new -s opencode # 在会话里启动 opencode web # Ctrl+B D 脱离 tmux new -s tunnel # 在会话里启动 cloudflared # Ctrl+B D 脱离

这样断开 SSH 后两个进程继续跑，手机随时连隧道地址接管 Agent。