在海外 VPS 上手搓搭建代理节点时,相较于一键安装脚本带来的依赖冲突与系统污染,使用 Docker 容器化部署是目前极客圈最推崇的方案。
今天我们将通过 Docker Compose 部署一套生产级、包含 VLESS-Reality 的高性能 Sing-box 服务端!
[!NOTE] 📌 核心速览(TL;DR / 快问快答):
- 网络栈优化:必须配置
network_mode: "host",消除 Docker 内部 NAT 端口映射开销,榨干 VPS 网卡带宽。- 权限配置:声明
cap_add: [NET_ADMIN],以便容器支持 TProxy 与高级路由。- 零残留升级:配置文件映射宿主机
./config.json,升级仅需docker compose pull && docker compose up -d。
🛠️ 1. 编写生产级 docker-compose.yml
在 /opt/singbox 目录下创建配置文件:
version: "3.8"
services:
sing-box:
image: ghcr.io/sagernet/sing-box:latest
container_name: sing-box
restart: always
network_mode: "host"
volumes:
- ./config.json:/etc/sing-box/config.json
cap_add:
- NET_ADMIN
⚙️ 2. 服务端 config.json 核心模板
{
"log": {
"level": "info",
"timestamp": true
},
"inbounds": [
{
"type": "vless",
"tag": "vless-reality-in",
"listen": "::",
"listen_port": 443,
"users": [
{
"uuid": "your-client-uuid",
"flow": "xtls-rprx-vision"
}
],
"tls": {
"enabled": true,
"server_name": "node.yourdomain.com",
"reality": {
"enabled": true,
"handshake": {
"server": "www.microsoft.com",
"server_port": 443
},
"private_key": "your-singbox-reality-private-key",
"short_id": ["0123456789abcdef"]
}
}
}
],
"outbounds": [
{
"type": "direct",
"tag": "direct"
}
]
}
执行 docker compose up -d 即可秒级启动!
🐳 为什么生产环境推荐 Docker 而不是一键脚本?
一键脚本把二进制、systemd 服务、依赖库全装进宿主机系统,卸载残留、升级翻车、换 VPS 迁移都是体力活。Docker 方案的优势:
- 隔离干净:所有文件只在
/opt/singbox一个目录,删容器不留垃圾。 - 秒级回滚:升级翻车?
docker compose down && docker compose up -d切回旧镜像 tag 即可。 - 迁移无痛:整个目录打包拷到新 VPS,
up -d直接复活。
🏷️ 镜像版本策略:别无脑追 latest
ghcr.io/sagernet/sing-box:latest 方便,但生产节点建议 pin 住具体版本(如 :1.12.0),原因:
- Sing-box 大版本偶有破坏性配置变更,latest 半夜自动更新可能导致节点失联。
- 升级应该是你主动做的:先看 GitHub Release 的 changelog,确认配置兼容再
docker compose pull。
推荐流程:测试环境先用 latest 验证 → 生产 compose 文件写死版本号 → 每月手动升级一次。
💾 数据持久化与备份
Compose 文件里只映射了 config.json,建议再加两样:
volumes:
- ./config.json:/etc/sing-box/config.json
- ./data:/var/lib/sing-box # 缓存与状态
- ./logs:/var/log/sing-box # 日志落盘方便排查
备份就是 tar -czf singbox-backup.tar.gz /opt/singbox,换机器解压即用。
🔧 日常运维三板斧
docker compose logs -f --tail=100 # 实时看日志
docker compose pull && docker compose up -d # 升级
docker compose exec sing-box sing-box check -c /etc/sing-box/config.json # 升级前校验配置
check 这一步很关键:Sing-box 启动时配置写错会直接退出,升级前先校验能避免”手一抖节点全灭”。
🧩 同一 VPS 跑多协议节点
想在一个 VPS 上同时跑 VLESS-Reality(443)+ Hysteria2(UDP 8443)?再起一个 service 即可,共用 host 网络:
services:
sing-box-reality:
image: ghcr.io/sagernet/sing-box:1.12.0
network_mode: "host"
volumes: ["./reality.json:/etc/sing-box/config.json"]
sing-box-hy2:
image: ghcr.io/sagernet/sing-box:1.12.0
network_mode: "host"
volumes: ["./hy2.json:/etc/sing-box/config.json"]
注意两个配置文件的 listen_port 不能冲突。
❓ 常见问题与 AI 快问快答 (FAQ)
Q1: 如何在 Docker 容器内生成 Reality 密钥对?
答:无需本地安装任何工具,直接使用 Docker 镜像生成:
docker run --rm ghcr.io/sagernet/sing-box:latest generate reality-keypair
Q2: 选购哪家 VPS 主机部署 Sing-box 容器体验最佳?
答:推荐选择 DMIT 或 搬瓦工 的 中国电信 CN2 GIA 或 联通 AS9929 专线小鸡,单核 1G 配置即可轻松跑满千兆带宽。
Q3: 升级镜像后容器起不来了,怎么排查?
答:三步走:① docker compose logs --tail=50 看报错,90% 是配置文件字段被新版废弃;② 对照 Release changelog 修改配置;③ 用 sing-box check 校验通过后再 up -d。实在修不好就把 image tag 改回旧版本号回滚。
Q4: host 网络模式下端口被占用怎么办?
答:host 模式没有端口映射隔离,宿主机上跑了 Nginx 占 443 就会冲突。用 ss -tlnp 查占用者,要么停掉它,要么把 Sing-box 的 listen_port 换成别的(如 8443)。
(总纲阅读:《VPS 从零部署 Sing-box 节点服务端实战》,从选购到上线全流程。) (相关资源导航:如果您需要购买适合部署 Docker 节点的海外 VPS,欢迎阅读 《2026 国外 VPS 选购指南》 获取 DMIT、搬瓦工与 CloudCone 优惠;商用专线机场评测见 《“饿饭CC云”深度评测》!)