opencode远程调试教程:手机控制服务器Agent执行任务 ----linux版
·
通过手机远程访问服务器 OpenCode 完整指南
整体架构
[远程 Linux 服务器] [手机/任意设备]
opencode web (:4096) ←──公网隧道──→ 浏览器访问公共 URL
cloudflared tunnel xxx.trycloudflare.com
核心思路: 不依赖本地电脑、不依赖 VS Code 端口转发。直接在远程 Linux 服务器上同时运行 opencode web 和 cloudflared tunnel,把服务通过 Cloudflare 公网隧道暴露,手机用浏览器访问返回的 URL 即可。
步骤一:从 GitHub 下载并安装 cloudflared(Linux 服务器)
1.1 确认服务器架构
uname -m
常见输出:
aarch64→ 对应arm64x86_64→ 对应amd64
1.2 下载二进制文件
访问 https://github.com/cloudflare/cloudflared/releases ,根据上一步架构选择对应文件下载到本地:
| 架构 | 文件名 |
|---|---|
| aarch64 / arm64 | cloudflared-linux-arm64 |
| x86_64 / amd64 | cloudflared-linux-amd64 |
也可以在 Windows 电脑先通过浏览器下载,再用
scp或 VS Code 传到服务器任意目录。
1.3 赋予执行权限
假设文件上传到服务器路径 /your/path/cloudflared-linux-arm64:
chmod +x /your/path/cloudflared-linux-arm64
1.4 使 cloudflared 可在任意目录调用(任选其一)
方式一:加入 PATH(推荐)
mkdir -p ~/bin
ln -s /your/path/cloudflared-linux-arm64 ~/bin/cloudflared
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
方式二:复制至系统目录(需 sudo)
sudo cp /your/path/cloudflared-linux-arm64 /usr/local/bin/cloudflared
sudo chmod +x /usr/local/bin/cloudflared
方式三:临时使用,每次用完整路径调用(无需配置)
/your/path/cloudflared-linux-arm64 --version
1.5 验证安装成功
cloudflared --version
输出类似 cloudflared version 2026.6.1 即表示安装成功。
步骤二:启动 OpenCode Web 服务
OPENCODE_SERVER_PASSWORD=你的密码 opencode web --hostname 0.0.0.0 --port 4096
参数说明:
| 参数 | 作用 | 是否必填 |
|---|---|---|
OPENCODE_SERVER_PASSWORD=你的密码 | 设置登录密码 | 强烈推荐,否则服务无认证 |
--hostname 0.0.0.0 | 监听所有网卡 | 必填,否则只能 localhost 访问 |
--port 4096 | 监听端口 | 可选,默认 4096 |
说明:
- 启动后会输出访问地址,出现
xdg-open报错可忽略(服务器无图形界面,不影响服务) - 登录凭据: 用户名
opencode,密码即OPENCODE_SERVER_PASSWORD中设置的值
保持此终端窗口不关闭。
步骤三:启动 cloudflared 公网隧道
另开一个 SSH 窗口 登录同一台服务器(不能关闭步骤二的 opencode 进程):
cloudflared tunnel --url http://localhost:4096
如果步骤一中没有配置 PATH 或复制至系统目录,把
cloudflared换成完整路径:
/your/path/cloudflared-linux-arm64 tunnel --url http://localhost:4096
终端会输出一个公网地址,例如:
Your quick Tunnel has been created! Visit it at:
https://links-ever-contamination-dealers.trycloudflare.com
复制此地址,保持此窗口不关闭。
步骤四:手机或任意设备访问
手机(4G/WiFi/任意网络)浏览器打开上一步的地址:
- URL:
https://xxx-yyy-zzz.trycloudflare.com - 用户名:
opencode - 密码:步骤二设置的密码

更多推荐



所有评论(0)