在工作电脑启动网关
先打开 Codex App。在网关的“网络访问”启用局域网访问,选择实际使用的网卡,保存并启动网关。
确认结果:App 显示类似 http://192.168.1.10:8787 的局域网地址。
SETUP / 连接配置
选好访问方式,照着图示和步骤配置。每一步都说明在哪操作、需要什么权限,以及看到什么才算成功。
当前公开下载为 v2.1.3 正式版,包含下方“已有穿透 / 反向代理”连接方式。配置外网前先安装并登录所需桌面客户端。
安装软件、调整 SSH 和防火墙等管理员操作由你或管理员在服务器手动执行。App 不接收 sudo 密码;网页上的“复制”只复制文本,不会执行命令。
适合手机和工作电脑处于同一可互访网络。
先打开 Codex App。在网关的“网络访问”启用局域网访问,选择实际使用的网卡,保存并启动网关。
确认结果:App 显示类似 http://192.168.1.10:8787 的局域网地址。
用手机打开 App 显示的地址或扫码登录。不要在手机输入 localhost 或 127.0.0.1,那表示手机自己。访客 Wi-Fi、AP 隔离和单位网络策略可能阻止设备互访。
确认结果:能登录、读取聊天;在自己的测试聊天中发送一条消息并收到回复。
推荐个人快速接入:无需域名和服务器,配置最少、上手最快。网关与隧道进程持续运行且连接正常时,通常可以沿用当前地址;Cloudflare 不保证永久占用或持续可用。隧道重建导致地址变化后,启用“每次启动网关及入口变化时发送地址”并配置好通知渠道,即可接收新地址;送达时间取决于网络与通知服务。
适合先体验外网访问,可以接受地址变化。
打开 Codex App,在网关添加“临时 HTTPS · Cloudflare”,勾选启用,保存后启动网关。带内置 cloudflared 的安装包无需另装连接器;较早的安装包若提示缺少组件,先在“运行配置”完成安装。
确认结果:App 显示以 https:// 开头、以 .trycloudflare.com 为域名后缀的地址。
关闭 Wi-Fi,打开 App 刚显示的地址,使用网关账号密码或有效的登录二维码。地址通知可帮助你在地址变化后找回新入口。
确认结果:登录、读取和发送均成功。停止网关或电脑休眠后,入口不可用。
需要长期固定地址时,使用 Cloudflare 固定隧道或自有服务器方案;不要靠域名反复重定向到临时地址。
Tailscale 公网转发或中继链路可能经过境外节点,中国大陆直连可能较慢或超时;私有组网直连与公网 Funnel 的访问路径不同。
无需自建服务器、购买域名或邀请码。在工作电脑安装官方客户端,再从网关接入。
v2.0.0 已支持。在网关电脑安装并登录官方 Tailscale,首次使用按提示完成 Serve / Funnel 授权。
从官方来源安装 Tailscale 1.52 或更高版本并登录。macOS 使用官网独立安装包来运行 Funnel,并允许系统网络扩展;Windows、Linux 需确保官方服务运行,且当前用户可以调用命令行客户端。
在“网络访问”添加“固定 HTTPS · Tailscale”,选择“公网访问 · Funnel”并保存。点击“检测 Tailscale 并读取地址”,再保存一次。保留网关登录验证。HTTPS 地址由 Tailscale 提供,无需填写 DNS 解析或上传证书。
确认结果:网关显示属于这台电脑的 .ts.net 地址。不要填写上方图示中的示例地址。
启动网关。如提示授权,点击“继续 Tailscale 授权”,在官方页面启用 HTTPS/Funnel;无权限时需要 Tailscale 网络管理员启用。首次开通的公网 DNS 最多可能需要 10 分钟生效。
默认使用 443 端口。若已有 Tailscale 服务占用,可选择 8443 或 10000,再检测并保存。网关不会覆盖原有服务,也不会退出 Tailscale 账号。
先在网关点击“检测固定入口”,再用手机扫码配对或登录。验证 Funnel 时关闭 Wi-Fi,并断开手机上的 Tailscale,以确认普通公网访问。测试聊天加载、发送、文件下载和重新连接。
保留设备身份和名称时,正常重启后地址不变。设备改名、删除或更换账号后,需要重新检测并保存。
私有访问:选择“私有组网 · Serve”,只有已接入同一 Tailscale 网络并获授权的设备可以访问。手机 App 未内嵌 Tailscale 客户端。
Cloudflare Tunnel 的访问链路可能经过境外节点,中国大陆直连可能较慢或超时;稳定的代理线路可能改善访问体验,实际速度以当前网络为准。
进阶方案需要具备 DNS、HTTPS、SSH、服务器或 NAS 管理等相关知识。本文命令与配置仅供参考,不保证适合你的环境;执行前请自行核对、备份并取得必要授权。使用、修改或执行这些示例的风险由使用者自行承担。在适用法律允许的最大范围内,项目作者与贡献者不对由此造成的数据丢失、服务中断、安全事件、费用或其他损失承担责任;依法不得排除或限制的责任除外。
下方步骤对应 v2.0.0 网关。请先准备服务器与 HTTPS 入口,再启用连接。
需要自己的域名、Cloudflare 账号,以及保持在线的工作电脑。
所有域名、IP、账号都是演示值。请替换为自己的信息;try2love.com 不是本教程提供的可访问演示服务。
在 Cloudflare 添加自己的域名,选择适合的套餐,核对已有网站、邮箱等 DNS 记录。复制 Cloudflare 分配的两条名称服务器(NS)。在购买域名的注册商处,将域名的 DNS 服务器改为这两条地址。
这是修改域名的名称服务器,不是添加两条普通 A 记录。域名仍在原注册商续费;生效后解析记录在 Cloudflare 管理。
确认结果:Cloudflare 中域名状态为 Active。若长期 Pending,核对 NS 拼写及原 DNSSEC 配置,按官方迁移说明处理。
官方:接入域名与名称服务器 ↗进入 Tunnels,创建 Cloudflared 类型的隧道,命名后查看连接器安装命令。只复制其中的 Tunnel Token,通常是 --token 后的一长串内容;不是 API Key,也不是整条命令。不要将 Token 发到公开页面或截图中。
带内置连接器的 App 会负责运行隧道,无需再手动执行安装命令。
确认结果:已取得这条隧道的 Token;接下来在 App 保存。
| App 字段 | 填写内容 |
|---|---|
| 连接方式 | 固定域名 · Cloudflare Tunnel |
| 手机访问地址 | https://codex.try2love.com |
| Tunnel Token | 上一步的 Token |
启用连接、保存配置,然后启动网关。配置被锁定时先停止网关,保存后再启动。
确认结果:Cloudflare 中连接器显示 Connected / Healthy。此时仍需配置公开路由。
在该隧道的 Routes / Published application / Public Hostname 页面添加公开应用。不同控制台版本名称可能不同,目标是创建一个主机名到服务的路由。
| 路由字段 | 示例 |
|---|---|
| 子域名 / Subdomain | codex |
| 域名 / Domain | try2love.com |
| 路径 / Path | 留空 |
| 服务类型 / Type | HTTP |
| 服务地址 / URL | localhost:8787 |
若只有一个服务地址输入框,填 http://localhost:8787。端口须与 App 的监听端口一致。不要填手机的 HTTPS 地址,也不要把 A 记录指向电脑局域网 IP。
确认结果:保存后产生指向该隧道的 DNS 记录;同名记录冲突时先核对用途,不覆盖其他网站。
进入域名的“规则 → 概述 → 创建规则 → 重定向规则”,选择自定义筛选表达式。下面仅匹配网关子域名;请替换示例域名。
(http.request.full_uri wildcard r"http://codex.try2love.com/*")
URL 重定向类型选“动态”,目标表达式如下;状态码选 301,勾选“保留查询字符串”,校验通过后部署。
concat("https://codex.try2love.com", http.request.uri.path)
确认结果:打开 http://codex.try2love.com 会自动变为 HTTPS,再显示登录页。已经打开的 HTTP 登录页需重新打开。
App 点击“检测固定入口”,然后手机关闭 Wi-Fi,用蜂窝网络打开域名。使用网关账号密码登录,不是 Cloudflare 密码或服务器 SSH 密码。
确认结果:入口检测通过,手机可登录、读取聊天、发送并收到回复。
进阶方案需要具备 DNS、HTTPS、SSH、服务器或 NAS 管理等相关知识。本文命令与配置仅供参考,不保证适合你的环境;执行前请自行核对、备份并取得必要授权。使用、修改或执行这些示例的风险由使用者自行承担。在适用法律允许的最大范围内,项目作者与贡献者不对由此造成的数据丢失、服务中断、安全事件、费用或其他损失承担责任;依法不得排除或限制的责任除外。
下方步骤对应 v2.0.0 网关。请先准备服务器与 HTTPS 入口,再启用连接。
公网服务器提供固定 HTTPS 入口,工作电脑主动建立回程隧道。
服务器负责 HTTPS 入口和转发;Codex 和网关运行在工作电脑。先完成一次服务器配置,之后日常只需启动电脑网关。
所有域名、IP、账号都是演示值。请替换为自己的信息;try2love.com 不是本教程提供的可访问演示服务。
| 先记下这些信息 | 本文演示值 | 用途 |
|---|---|---|
| 服务器公网 IPv4 | 203.0.113.10 | DNS 与 SSH;此 IP 是文档示例 |
| 固定访问地址 | https://codex.try2love.com | 手机浏览器与 App |
| 普通 SSH 用户 | try2love | 日常隧道,不需要 sudo |
| SSH 端口 | 22(以服务器实际设置为准) | 电脑连接服务器 |
| 服务器回环端口 | 18787 | HTTPS 反代与隧道两端配置须一致 |
| 电脑网关端口 | 8787 | App 监听端口 |
“手机访问地址”可留空。使用域名时,需要自行解析到服务器公网 IP 并配置 HTTPS;留空时,从 SSH 服务器地址(或别名的 HostName)中的公网 IP 自动填入 https://公网IP。服务器仍需配置反向代理,以及 Subject Alternative Name 包含该 IP 的受信任证书;仅有 SSH 不能直接访问。
先通过已有的 SSH 方式或云厂商控制台登录服务器。下面的命令只查询系统和监听端口,不安装或修改服务。
cat /etc/os-release
id
ss -ltn
command -v caddy
command -v nginx
Ubuntu / Debian 可用下文 apt 安装路径。看到 :80、:443 已监听,或知道自己使用了宝塔、1Panel、Nginx、Caddy,就选择“已有网站或面板”,不要再启动第二套 Web 服务。命令无输出可能只是未安装该程序;无权限查看的项目标为未确认。
在云控制台核对公网地址及入站规则。只有私网地址、必须连校园网或 VPN 才能访问的服务器,不能仅靠“SSH 登录成功”成为手机公网入口。需要管理员提供公网 HTTPS 入口,或改用 Cloudflare 固定隧道。
查看 Cloudflare 固定域名方案确认结果:已确定系统、是否有现成网站,以及谁能执行管理员操作。
在实际托管 DNS 的平台添加记录。如果名称服务器已迁移到 Cloudflare,就在 Cloudflare 添加,不能继续在原注册商的旧解析区修改。
| 字段 | 填写 |
|---|---|
| 类型 | A |
| 主机记录 | codex |
| 记录值 | 你的服务器公网 IPv4 |
| TTL | 默认 / 自动 |
| Cloudflare 代理状态(首次验证) | 仅 DNS,灰云 |
只有服务器具备可用公网 IPv6 时才添加 AAAA。若该子域名已用于 Cloudflare Tunnel,不要覆盖它;先用新的子域名测试服务器方案。不要把域名解析到 127.0.0.1 或电脑的 192.168.x.x 地址。
nslookup codex.try2love.com
确认结果:在工作电脑运行 nslookup,结果是服务器公网 IP。DNS 生效可能需要等待缓存更新。
| 端口 | 在哪开放 | 访问范围 |
|---|---|---|
| 实际 SSH 端口 | 云安全组 + 服务器防火墙 | 允许工作电脑来源,保留现有管理入口 |
| TCP 80 / 443 | 云安全组 + 服务器防火墙 | 公网;用于 HTTPS 与证书验证 |
| 18787 | 不添加公网放行规则 | 仅服务器 127.0.0.1 |
| 电脑 8787 | 不做公网端口映射 | 电脑本地网关 |
由管理员先查看状态。仅在 UFW 已启用时添加 Web 端口规则;不要为本教程启用、重置防火墙或关闭现有 SSH 入口。云安全组还需要单独配置。
sudo ufw status verbose
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
使用 firewalld、云防火墙或面板防火墙时,由管理员在现有系统中添加同等规则。单位服务器若不能开放公网 80/443,需要管理员提供其他已配置好的 HTTPS 入口。
确认结果:已核对云安全组和主机防火墙两层规则;接下来还要启动 HTTPS 服务并做外网验证。
已有可登录的普通用户就直接使用,不必创建专用账号,也不必授予 sudo。先在工作电脑终端验证登录,退出后再填 App。首次连接的主机指纹应与服务器控制台或管理员提供的结果核对。
ssh -p 22 try2love@203.0.113.10
Ubuntu / Debian 管理员可执行下面命令创建账号。按提示设置账号密码;这不会自动给新用户 sudo 权限。不要为方便登录而全局启用 SSH 密码认证。
sudo adduser try2love
服务器已允许密码登录时,先验证该普通用户能正常登录。服务器仅允许密钥时,按下一项安装公钥。其他系统请由管理员使用该系统的用户管理方式创建账号。
已有可用私钥就直接使用。需要新建时,在工作电脑运行 ssh-keygen,按提示保存到一个新的文件名,避免覆盖已有密钥;建议设置私钥口令。
ssh-keygen -t ed25519
将生成的 .pub 公钥交给管理员追加到该用户的 ~/.ssh/authorized_keys。私钥保留在工作电脑。以下是 Ubuntu / Debian 默认 /home/try2love 家目录的示例;已有文件只追加,不覆盖。
sudo install -d -m 700 -o try2love -g try2love /home/try2love/.ssh
sudoedit /home/try2love/.ssh/authorized_keys
sudo chown try2love:try2love /home/try2love/.ssh/authorized_keys
sudo chmod 600 /home/try2love/.ssh/authorized_keys
在 App 选择“本地私钥”,选没有 .pub 后缀的私钥文件;设置过口令时同时填写口令。不要把私钥或密码放到公开配置和截图中。
确认结果:工作电脑能以普通用户登录服务器。服务器 SSH 密码与手机网关登录密码是两套凭据。
已允许转发时可以沿用现有配置。需要调整时,让管理员检查现有 sshd_config、Include 文件、Match 条件及公钥限制,再为目标用户添加或调整以下规则;不要覆盖整个 SSH 配置。
Match User try2love
AllowTcpForwarding remote
GatewayPorts no
PermitListen 127.0.0.1:18787
Match all
AllowTcpForwarding remote 允许反向转发;PermitListen 限制监听地址;GatewayPorts no 保持回环监听。已有 DisableForwarding yes、较早匹配的规则或 authorized_keys 的 restrict / no-port-forwarding 仍可能阻止转发。
sudo sshd -t
语法检查无输出且退出码为 0 才继续。Ubuntu / Debian 通常使用下面的 ssh 服务;其他系统先确认实际服务名。保留当前 SSH 终端,并在新终端再次验证登录。
sudo systemctl reload ssh
确认结果:新终端登录正常。真正的转发权限还需在第 7 步启动 App 隧道后验证。
官方:OpenSSH 转发权限 ↗四种路径选一种即可。上游始终是 SSH 服务器自身的 http://127.0.0.1:18787;不是工作电脑的局域网 IP。
确认 80/443 未被现有服务占用,且未安装 Caddy,再由管理员按官方软件源安装。一次运行一条命令,失败时先处理错误。安装 Caddy 后会创建并启动系统服务。
sudo apt update
sudo apt install --yes debian-keyring debian-archive-keyring apt-transport-https curl gnupg
curl -1sLf https://dl.cloudsmith.io/public/caddy/stable/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy
先备份再编辑 Caddyfile。把演示域名改为自己的域名;新安装文件中的示例 :80 站点可替换为下面的站点块。若文件已有真实网站,转到路径 B。
sudo cp -a /etc/caddy/Caddyfile /etc/caddy/Caddyfile.before-codex-$(date +%Y%m%d%H%M%S)
sudoedit /etc/caddy/Caddyfile
codex.try2love.com {
reverse_proxy 127.0.0.1:18787 {
header_up Host {http.request.host}
flush_interval -1
}
}
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy
systemctl is-active caddy
只有 validate 成功后才 reload;最后应显示 active。Caddy 自动申请和续期证书,并处理 HTTP → HTTPS。
官方安装步骤 ↗先备份配置,为网关使用一个独立域名站点,不覆盖原站点,也不停止现有 Web 服务。
在实际使用的 Caddyfile 或已被 import 的站点文件中添加以下站点块。原有站点保持不变,确认未为同一域名重复定义站点。
codex.try2love.com {
reverse_proxy 127.0.0.1:18787 {
header_up Host {http.request.host}
flush_interval -1
}
}
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy
先用现有证书工具或面板为网关域名配置有效 HTTPS 证书与 HTTP → HTTPS 跳转。将以下 location 放入该域名的 HTTPS server 块;如果已经有 location /,只调整该站点,不重复添加。这里不包含证书签发步骤,不能直接当成完整 Nginx 配置文件。
location / {
proxy_pass http://127.0.0.1:18787;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
}
sudo nginx -t
sudo systemctl reload nginx
仅在 nginx -t 成功后重新加载。Caddy/Nginx 若由面板或容器管理,应使用其现有配置和重载方式,不另建 systemd 服务。
在现有面板中新建独立域名站点或反向代理条目,保留其他站点。不同版本菜单名称不同,逐项对应下面的字段即可。
| 面板设置 | 内容 |
|---|---|
| 域名 | codex.try2love.com |
| 上游协议与地址 | HTTP · 127.0.0.1:18787 |
| 发送给上游的 Host | 原始访问域名 codex.try2love.com |
| SSL / HTTPS | 为此域名申请有效证书,启用 HTTP 跳转 |
| 缓存与流式响应 | 关闭代理缓存、关闭响应缓冲 |
如果面板反代运行在容器中,127.0.0.1 指向容器自己,可能不是 SSH 服务器。让管理员确认网络命名空间与安全可达的上游,不要为了连通而把 18787 暴露到公网。
其他 Linux 系统按 Caddy 官方安装页选择对应包管理器,后续域名、上游和验收步骤相同。不要在 Rocky / AlmaLinux 等系统照抄 apt 命令。Windows 服务器不在这份 Linux 命令教程范围内,请由管理员提供等效的 SSH 与 HTTPS 服务。
已有 Linux Docker Engine 时,可使用 App“导出手动配置参考”中的 Caddy Compose 方案。仅在 80/443 空闲时启动,保留证书卷;该方案使用 host 网络,必须与 SSH 服务在同一 Linux 主机。Docker 不是绕过管理员权限的方法。
没有管理员权限时,将第 2—6 步交给管理员完成。你只需普通 SSH 用户和允许的转发端口,不需要申请 sudo 权限。App 的“复制服务器检查 Prompt”可先让服务器内的 Agent 只读检查,不能代替管理员授权。
按系统选择 Caddy 安装方法 ↗确认结果:HTTPS 证书正常、HTTP 会跳到 HTTPS。隧道尚未启动时显示 502 可能是预期状态;看到默认证书错误或其他网站则先修正此步。
| App 字段 | 示例 |
|---|---|
| 连接方式 | 固定域名 · 自有服务器 + SSH |
| 手机访问地址 | https://codex.try2love.com |
| 服务器地址 | 203.0.113.10 |
| SSH 端口 | 22(实际端口) |
| SSH 用户名 | try2love |
| 认证方式 | 沿用已验证的密码、私钥、Agent 或 SSH 别名 |
| 服务器回环端口 | 18787;与反代上游一致 |
保存配置,核对首次主机指纹,再点击“检查 SSH 登录”。登录通过后启用该连接并保存,点击“启动 SSH 连接”。若服务器配置被禁用,检查可以执行,但不会建立转发。
“检查 SSH 登录”只证明认证成功。不要把它当作证书、转发权限或手机公网访问已经通过。App 不会执行 sudo,也不会自动安装服务器软件。
确认结果:SSH 状态显示转发已建立。服务器上 ss -ltn 可以看到 127.0.0.1:18787;不应是 0.0.0.0:18787。
先在服务器确认反向隧道能到达电脑网关。Host 必须使用已经在 App 保存的访问域名。此请求不包含密码。
curl --max-time 10 -H 'Host: codex.try2love.com' http://127.0.0.1:18787/api/auth
应返回包含 authenticated 等字段的 JSON。然后在 App 点击“检测固定入口”,比较固定 HTTPS 地址与本机网关实例。最后用手机蜂窝网络验证登录、聊天读取和发送。
确认结果:三层都通过。之后无需日常 sudo 操作,电脑保持开机、联网且不休眠,网关会维持并重试 SSH 连接。
v2.1.0 正式版已支持。复用已有受信任的 HTTPS 穿透或反向代理访问网关。
仅当网关实际使用 8787 时,上游才填 http://127.0.0.1:8787;否则使用电脑 App 显示的实际端口。代理若在容器内运行,容器的 127.0.0.1 可能指向另一网络空间。
确认结果:穿透能连到这台电脑的网关,网关 HTTP 端口未直接暴露到公网。
在“网络访问 → 添加连接”选择“已有穿透 / 反向代理”,填写完整且证书受信任的 HTTPS 根地址,例如 https://bridge.example.com 或 https://bridge.example.com:8443。不能填公网 HTTP、/codex/ 子路径、查询参数或重定向地址;不要关闭证书校验。
保存并启动网关。同机穿透可关闭局域网和本机网页访问;回环上游只接受已配置的公开 Host。
保留原始公开 Host(含自定义端口)、Origin、Cookie 和 X-CSRF-Token。Nginx 用 $http_host 保留 :8443;$host 可能丢失端口。关闭缓存和响应缓冲,允许流式响应、长请求及所需上传/下载大小。Bridge 使用 HTTP 长轮询或 SSE;仅支持 WebSocket 升级仍不够。
在 App 点击“检测固定入口”:它用无凭据 HTTPS 请求核验证书与当前网关实例,不跟随重定向。再用手机蜂窝网络测试登录、聊天和文件;只有地址指向当前网关时才签发扫码登录。
若代理位于另一台 NAS 或服务器,请使用进阶 NAS 配置及它可达的电脑局域网地址,不能填写那台设备自己的回环地址。
阅读完整的已有穿透说明 ↗进阶方案需要具备 DNS、HTTPS、SSH、服务器或 NAS 管理等相关知识。本文命令与配置仅供参考,不保证适合你的环境;执行前请自行核对、备份并取得必要授权。使用、修改或执行这些示例的风险由使用者自行承担。在适用法律允许的最大范围内,项目作者与贡献者不对由此造成的数据丢失、服务中断、安全事件、费用或其他损失承担责任;依法不得排除或限制的责任除外。
需要已有公网 HTTPS 入口,并且 NAS 能访问工作电脑网关。
所有域名、IP、账号都是演示值。请替换为自己的信息;try2love.com 不是本教程提供的可访问演示服务。
在电脑 App 启用局域网访问,启动网关。从 NAS 的终端或已有诊断工具访问电脑的局域网地址。建议为电脑保留固定 DHCP 地址,避免上游变化。
curl --max-time 10 http://192.168.1.10:8787/api/auth
确认结果:返回网关 JSON。若超时,先解决路由、网卡或防火墙;两地网络不通时改用自有服务器 SSH 或 Cloudflare。
使用独立子域名,配置与之匹配的有效证书和 HTTP → HTTPS 跳转。已有公网入口可复用;没有时,必须先确认公网 IP、运营商入站限制及路由器转发条件。
自行暴露 NAS 入口时,只把必要的 HTTPS 端口转给 NAS 反代;证书方式若要求 HTTP 验证,再准备 80 端口。不要映射电脑 8787 或 NAS 内部中转 18787。CGNAT 或校园内网通常不能靠路由器端口映射解决公网访问。
确认结果:手机蜂窝网络能连接 NAS 的 HTTPS 域名,证书可信。
| 位置 | 字段 | 示例 |
|---|---|---|
| NAS 反代 | 来源 | HTTPS · codex.try2love.com · 443 |
| NAS 反代 | 目标 | HTTP · 192.168.1.10 · 8787 |
| NAS 反代 | Host / 缓冲 | 保留公网 Host,关闭缓存和响应缓冲 |
| 电脑 App | 连接方式 | 固定域名 · NAS / 已有反代 / Docker |
| 电脑 App | 手机访问地址 | https://codex.try2love.com |
| 电脑 App | NAS 可访问的电脑地址 | http://192.168.1.10:8787 |
保存并启用连接,重新启动网关,再检测固定入口。使用域名根路径,不要配置为 /codex/ 等子路径。
确认结果:App 检测通过,手机蜂窝网络可以登录并收发消息。
NAS 已能直接反代到电脑时,不需要再加 Docker。只有确实需要中间 HTTP 转发时,才使用 App 导出的 NAS 部署包。
该包的容器提供 HTTP 中转,不能独立代替 NAS 的证书和公网 HTTPS。若外层反代运行在宿主机,上游可用 http://127.0.0.1:18787;若它也在容器中,127.0.0.1 指向该容器自己,需按部署包说明设置可达的 NAS 地址并限制访问。
Docker 操作由有权限的用户自行完成。先查看导出包中的部署说明,核对端口和网络,再运行配置检查;不要为了本教程修改其他容器或公开内部端口。
| 看到什么 | 先查哪里 |
|---|---|
| 域名找不到 / DNS 错误 | DNS 在哪托管、记录值、NS 是否生效、是否存在错误 AAAA |
| 连接超时 | 公网 IP、安全组、防火墙、服务监听;分别检查手机与服务器网络 |
| 证书错误 | 域名与证书是否匹配、证书签发日志、80/443 可达性 |
| Cloudflare 1033 | 连接器是否在线、隧道 Token 与隧道是否一致 |
| 502 / 504 | 反代上游端口、SSH 隧道、NAS 到电脑路由;不要先改登录密码 |
| 首页可见,登录报跨站错误 | 浏览器是否在 HTTP;先配置 HTTPS 跳转并重新打开页面 |
| SSH 登录成功,转发不成功 | 转发权限、回环端口占用、公钥限制、其他 Match 规则 |
| 回复等很久才整段出现 | 反代响应缓冲与缓存;保持流式响应 |
| 检测提示不是当前网关 | DNS、站点 Host 和上游是否指到了其他实例 |
检测固定入口只能证明执行检测的电脑能经 HTTPS 连到当前网关;手机关闭 Wi-Fi 的真实访问,才是外网链路的最后验收。
Caddy 自动 HTTPS 官方说明 ↗ · Nginx 反向代理官方说明 ↗