跨越内外网的
星之桥梁

登录面板并修改默认密码

浏览器访问 http://服务器IP:7500，使用默认账号登录：

登录后点击右上角用户名 → 修改密码，把默认密码改掉（服务对外开放后这一步务必执行）。

创建客户端

左侧菜单 → 客户端管理 → 右上角「添加客户端」：

· 名称：给这台内网机器起个好认的名字，如「公司电脑」「家里NAS」
· 最大连接数：允许同时存在的数据连接数，一般 100 够用

创建完成后列表会出现该客户端，同时生成唯一的「客户端令牌（Token）」。

添加端口映射（后端转发规则）

在客户端列表点击名称进入 客户端详情 → 「端口映射」→ 「+ 添加映射」：

复制一键连接信息（推荐）

客户端详情 → 「基本信息」→ 一键连接信息 → 点击「复制」，得到形如 XQ1.eyJ0aW1lI… 的加密串。

把这段文字发给要部署客户端的机器（微信/邮件都行），客户端粘贴即可自动填入服务器地址、端口和令牌，无需手抄任何配置。

系统设置（可选）

左侧菜单 → 系统设置（仅超级管理员可见）可在线修改全部服务端配置：隧道端口、面板端口、HTTPS 证书、会话超时、登录限流等。

多用户（可选）

左侧菜单 → 用户管理（仅超管可见）可创建普通管理员账号并分配可管理的客户端。适合多人共用一台服务器、各管各自隧道的场景。

接下来：Windows 机器请看 ③ 客户端·Windows；Linux 机器请看 ③ 客户端·Linux。

准备文件

在客户端/ 中拿到：

把两个文件放在同一目录，例如 D:\xingqiao\。建议在桌面建个快捷方式。

启动并一键导入连接信息

双击 jiu.exe，任务栏右下角出现托盘图标。右键图标 → 设置：

① 在顶部「一键导入」输入框中粘贴管理后台复制的 XQ1 连接信息
② 点击「导入」→ 服务器地址、服务器端口、令牌自动填入
③ 无需任何手抄配置，也不会抄错

配置端口映射（前端转发规则）

在设置页「端口映射」中添加一条规则，与面板中创建的映射远程端口保持一致：

保存并连接

点击「保存」→「连接」。托盘图标悬停提示「已连接」，管理后台客户端状态变为 在线 即成功。

开机自启：右键托盘图标 → 勾选「开机自启」，以后开机自动连。

上传客户端程序（注！如果你有宝塔可以参考服务端.宝塔部署方式）

在本地把 客户端 中的 jiu 与 client.json 上传到内网 Linux 机器（NAS / 树莓派 / 服务器均可），例如 /opt/xingqiao/：

scp build/客户端/client root@内网机器IP:/opt/xingqiao/
scp build/客户端/client.json root@内网机器IP:/opt/xingqiao/

编辑配置文件

编辑 /opt/xingqiao/client.json：

{
  "server_addr": "1.2.3.4",          // 公网服务器 IP 或域名
  "server_port": 7000,                 // 隧道端口，与服务端一致
  "token": "面板客户端详情里的令牌",
  "mappings": [
    {
      "name": "公司网站",
      "remote_port": 8080,            // 远程端口，与面板一致
      "local_addr": "127.0.0.1",      // 本地服务地址
      "local_port": 80                 // 本地服务端口
    }
  ],
  "pool_size": 5                      // 预建连接池大小（加速），0=默认5，-1=关闭
}

前台测试启动

cd /opt/xingqiao
chmod +x client
./client

日志出现「已连接」且管理后台客户端状态变为 在线 即成功，Ctrl+C 停止后配置守护。

systemd 开机自启（推荐）

cat > /etc/systemd/system/xingqiao-client.service << 'EOF'
[Unit]
Description=XingQiao Tunnel Client
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/xingqiao
ExecStart=/opt/xingqiao/client
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now xingqiao-client
systemctl status xingqiao-client

临时后台运行也可以用：nohup ./client > client.log 2>&1 &（不开机自启）。

浏览器访问验证

按上面示例（远程端口 8080、本地 80），在任意联网设备浏览器访问：

http://服务器IP:8080

看到内网机器 80 端口上的网站内容，说明整条链路（用户 → 服务端 → 隧道 → 客户端 → 本地服务）全部打通。

面板状态验证

管理后台 → 仪表盘：客户端在线数 +1、活跃连接随访问变化；客户端详情页的流量（入/出）、总连接次数会实时累计，可以确认数据走了星桥隧道。

常见排查

· 访问不通：检查远程端口是否在宝塔/云安全组放行；检查客户端映射的远程端口与面板一致
· 客户端连不上服务端：确认 7000 端口放行、token 正确、server_addr 是公网 IP
· 面板打不开：确认 7500 端口放行；服务端日志有无端口占用报错

上线！

至此星桥搭建完成。之后在面板上随时增删映射、在线调整配置，把更多内网服务安全地暴露到公网。