自托管 Coolify v4 或 Dokploy 的稳定性考验几乎都集中在 git push 触发构建的那几分钟:并发 pnpm build、TypeScript 检查与 zstd 镜像层压缩会与线上 PostgreSQL、Traefik 争抢同一套内核队列。在 Netcup RS 1000 G12.5(叠 #rs1 免 2 个月券后首年免税 €15.22/月)上,4 颗物理独享 AMD EPYC 9645 / 9655 (Zen 5) 线程、8 GB DDR5 ECC 内存、6.87 GB/s 企业级 NVMe RAID(4K Q1T1 写延迟 115.87 µs)与欧美 2.5 Gbps Fair-Use 免超额费端口可以通过 cgroup 硬隔离把编译负载锁死在安全水位内(下单前可快速核对 非欧盟 0% 免税注册指南 与 CCP 提前 1 个月通知期与合同期末退订指南)。
1. Debian 12 宿主机初始化:4 GB Swap、BBR 与 /etc/docker/daemon.json
在 SCP 部署纯净 Debian 12 (Bookworm) 后,请先执行以下宿主机初始化再运行面板安装脚本,让 Docker 首次启动就加载日志轮转与无冲突网段:
sudo apt update && sudo apt full-upgrade -y
sudo apt install -y curl git jq zstd rclone ca-certificates
# 1. 创建 4 GB NVMe Swap 缓冲池,吸收前端打包器瞬时内存尖峰
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# 2. 优先使用 DDR5 ECC 物理内存(swappiness=10)并在 2.5 Gbps 网卡开启 TCP BBR
cat <<'EOF' | sudo tee /etc/sysctl.d/99-paas-host.conf
vm.swappiness=10
vm.vfs_cache_pressure=50
net.core.default_qdisc=fq
net.ipv4.tcp_congestion_control=bbr
EOF
sudo sysctl --system
接着写入 /etc/docker/daemon.json。将单个容器 JSON 日志限制在 20m × 3 可防止半年后日志悄悄撑爆 128 GB NVMe 磁盘;live-restore 允许重启 Docker 守护进程时不中断线上容器;指定 172.80.0.0/16 地址池则彻底避开 Tailscale(100.64.0.0/10)与常见 WireGuard 内网(10.0.0.0/8 / 192.168.0.0/16)路由冲突:
sudo mkdir -p /etc/docker
cat <<'EOF' | sudo tee /etc/docker/daemon.json
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "3"
},
"live-restore": true,
"default-address-pools": [
{
"base": "172.80.0.0/16",
"size": 24
}
]
}
EOF
注意:如果准备安装 Dokploy(底层默认启用 Docker Swarm 模式),请删掉 "live-restore": true 这一行,因为 Docker 官方引擎不允许 live-restore 与 Swarm 同时开启。
2. 安装 Coolify v4 与 Dokploy(官方命令与架构对比)
在干净的 Debian 12 宿主机上二选一执行安装命令(切勿在同一台虚拟机混装两个面板,两者均会接管 80/443 端口与容器网络):
# 方案 A:Coolify v4 官方一键脚本(初始安装界面监听 TCP 8000)
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
# 方案 B:Dokploy 官方一键脚本(自动初始化 Swarm,初始界面监听 TCP 3000)
curl -sSL https://dokploy.com/install.sh | sh
| 技术对比维度 | Coolify v4 | Dokploy |
|---|---|---|
| 控制面空闲内存占用 | ~580–700 MB(Laravel/FrankenPHP + Postgres + Redis + Soketi) | ~280–380 MB(Node.js/Next + Postgres + Redis) |
| 容器编排与反向代理 | 标准 Docker Engine + Traefik 或 Caddy | Docker Swarm(单机或多节点集群)+ Traefik |
| 初始端口与实时通信 | TCP 8000 面板 + TCP 6001/6002(Soketi WebSocket 与网页终端) | TCP 3000 面板(实时日志通过主端口/反代复用) |
| 多机扩展与构建卸载 | 原生支持 SSH 挂载独立 Build Server 构建机 + 远程业务机 | Swarm 多工作节点扩展 + 远程 SSH 服务器部署 |
| 推荐 Netcup G12.5 机型 | RS 1000 G12.5(€15.22/月),重负载可配 RS 2000 | 轻量选 VPS 500 G12.5(新客叠 #5e 为 €6.52/月,常规 €6.94/月);含编译任务选 RS 1000 |
3. 双栈泛域名解析与 Netcup SCP 防火墙收敛策略
配置一次泛域名 A + AAAA 解析后,后续所有新增业务或 PR 预览子域名(如 api.apps.example.com、umami.apps.example.com)均可自动签发 Let’s Encrypt 证书,无需每次手动改 DNS:
deploy.example.com 300 IN A 203.0.113.42
deploy.example.com 300 IN AAAA 2a03:4000:60:1234::1
*.apps.example.com 300 IN A 203.0.113.42
*.apps.example.com 300 IN AAAA 2a03:4000:60:1234::1
在 Coolify(Settings → Instance's Domain)或 Dokploy(Settings → Web Server)绑定 https://deploy.example.com 并验证 HTTPS 登录成功后,立即进入 Netcup SCP → Firewall 在宿主机虚拟网卡层配置入站白名单(Docker 会直接改写 DOCKER-USER 链绕过系统内 ufw,因此在 SCP 硬件防火墙层拦截最彻底):
| 防火墙方向 | 协议与端口 | 来源地址 | 动作 | 安全作用说明 |
|---|---|---|---|---|
| 入站 (Inbound) | TCP 80 | 0.0.0.0/0, ::/0 | ACCEPT | HTTP 自动跳转 HTTPS 及 Let’s Encrypt HTTP-01 验证 |
| 入站 (Inbound) | TCP 443 & UDP 443 | 0.0.0.0/0, ::/0 | ACCEPT | Traefik/Caddy TLS 1.3 与 HTTP/3 QUIC 业务入口 |
| 入站 (Inbound) | UDP 51820 / UDP 41641 | 0.0.0.0/0, ::/0 | ACCEPT | WireGuard 或 Tailscale 点对点直连打洞 |
| 入站 (Inbound) | TCP 22 | WireGuard 内网 / 固定管理 IP | ACCEPT(其余 DROP) | 彻底阻断公网 SSH 暴力扫段 |
| 入站 (Inbound) | TCP 8000, 3000, 6001, 6002 | 0.0.0.0/0, ::/0 | DROP | HTTPS 生效后关闭明文初始化后台与 Soketi 裸端口防绕过 |
4. 构建防 OOM 限额与夜间 pg_dump 自动备份至 R2
未设上限的 Next.js、Vite 或 Rust 编译进程在 8 GB 机器上很容易瞬间吞掉 6 GB+ 内存并触发内核 OOM Killer 误杀数据库。为构建任务锁定 2.5 核与 4 GB 内存上限,即可始终留出 1.5 颗物理 Zen 5 核与 4 GB DDR5 ECC 内存保障线上请求:
# 构建期环境变量(Coolify -> Environment Variables -> Build Time / Dokploy -> Env)
NODE_OPTIONS=--max-old-space-size=3072
NEXT_TELEMETRY_DISABLED=1
CARGO_BUILD_JOBS=2
# RS 1000 G12.5(4C / 8G)构建与运行容器限额参数
--cpus="2.5" --memory="4g" --memory-swap="5g"
每次升级系统或面板前可在 SCP 手动打一个 €0 免费写时复制(CoW)整机快照;数据库层面则利用 2.5 Gbps 免出站费端口,每晚通过 pg_dumpall | zstd | rclone 流式备份至 Cloudflare R2 或 Hetzner Storage Box(提前通过 rclone config 配置名为 r2 的远程存储):
cat <<'EOF' | sudo tee /usr/local/bin/backup-paas-pg.sh
#!/usr/bin/env bash
set -euo pipefail
STAMP=$(date -u +"%Y-%m-%d_%H%M")
HOST_TAG=$(hostname -s)
# 遍历当前节点所有运行中的 PostgreSQL 容器并压缩直传对象存储
for CID in $(docker ps --format '{{.ID}} {{.Image}}' | awk '/postgres|pgvector/ {print $1}'); do
NAME=$(docker inspect --format '{{.Name}}' "$CID" | sed 's#^/##')
docker exec "$CID" pg_dumpall -U postgres --clean --if-exists \
| zstd -T2 -10 \
| rclone rcat "r2:netcup-backups/${HOST_TAG}/${NAME}_${STAMP}.sql.zst"
done
rclone delete --min-age 14d "r2:netcup-backups/${HOST_TAG}/"
EOF
sudo chmod 700 /usr/local/bin/backup-paas-pg.sh
echo "20 2 * * * root /usr/local/bin/backup-paas-pg.sh >> /var/log/paas-backup.log 2>&1" \
| sudo tee /etc/cron.d/paas-pg-backup
5. Coolify 与 Dokploy 生产常见故障排查表
| 故障现象 | KVM / Docker 根因定位 | 精确修复命令与设置 |
|---|---|---|
部署显示绿色但访问报 Traefik 502 Bad Gateway | 容器内进程仅监听 127.0.0.1 / ::1 回环地址,或双栈网络下 Traefik 转发端口未对齐。 | 环境变量显式指定 HOST=0.0.0.0 与 PORT=3000,并在 Coolify(Ports Exposes: 3000)或 Dokploy(Container Port: 3000)对齐端口。 |
Nixpacks / Docker 构建中断并报 exit code 137 | V8 堆内存或 rustc 超出 cgroup 限额且无 Swap 缓冲,被内核 SIGKILL 强杀。 | 执行 swapon --show 确认 4G 生效,构建变量添加 NODE_OPTIONS="--max-old-space-size=3072",重型仓库可升级至 RS 2000 G12.5(16 GB)。 |
/var/lib/docker/overlay2 报 no space left on device | 长期累积的 BuildKit 缓存层与悬空旧镜像占满 128 GB NVMe 分区。 | 开启面板定时清理开关,并执行 docker builder prune -af --filter "until=168h" && docker image prune -af --filter "until=168h"。 |
Coolify 构建实时日志卡住或网页终端连不上 (6001) | 反代丢弃了 WebSocket Upgrade 请求头,或浏览器尝试直连已被 SCP 防火墙封禁的 6001/6002 裸端口。 | 统一通过 https://deploy.example.com 访问后台(Traefik 会在 443 内部反代 /app 与 /terminal/ws);套 Cloudflare 时需开启 WebSockets 开关。 |
Let’s Encrypt 签发报 429 rateLimited 或无限重定向 | 域名未生效时连续重试触发每小时 5 次失败限流,或 Cloudflare SSL 误设为 Flexible(灵活)模式。 | 将 Cloudflare SSL/TLS 改为 Full (Strict),或在 Traefik 中配置 CF_DNS_API_TOKEN 走 DNS-01 泛域名签发。 |
上线前可在 容器选型与迁回计算器 中核对自身服务的内存余量,或参阅 Root-Server 独享核与 VPS 架构对比,再从下方复制可用的 #rs1 或 #rs2 免月优惠码。
RS 1000 G12.5 独享核主力款
免 2 个月月费 · 新老用户通用(选 12 个月合同期生效)