# Coolify v4 与 Dokploy 自托管实战指南：RS 1000 G12.5（€15.22/月）内核调优、防火墙与防 OOM

> 在 Netcup RS 1000 G12.5（免税 €15.22/月）部署 Coolify v4 与 Dokploy：Swap/BBR、daemon.json、SCP 防火墙、构建限额与 R2 备份。

- Canonical URL: https://euserverlab.com/zh/guides/coolify-dokploy-self-hosting-netcup-guide/
- Language: zh-Hans
- Published: 2026-11-04 | Updated: 2026-11-22
- Publisher: EUServerLab (https://euserverlab.com/zh/methodology/)

## 核心结论摘要
- 多人并发 git push 触发 Next.js、TypeScript 或 Rust 编译时，共享 vCPU 极易因抢占飙升拖垮同机数据库。Netcup RS 1000 G12.5 提供 4 颗 AMD EPYC 9645 / 9655 (Zen 5) 物理独享线程、8 GB DDR5 ECC 与 128 GB NVMe RAID（实测 6.87 GB/s），叠 #rs1 免月券首年免税月均 €15.22。
- 执行安装脚本前，先挂载 4 GB Swap（vm.swappiness=10）、开启 TCP BBR，并写入 /etc/docker/daemon.json 限制日志轮转（20m x 3）及自定义 172.80.0.0/16 容器网段。
- 管理后台绑定 HTTPS 域名后，立即在 Netcup SCP → Firewall 收敛入站规则：公网仅放行 TCP 80 与 TCP/UDP 443，SSH 走 WireGuard/Tailscale，直接丢弃 8000、3000、6001 与 6002 原始端口。
- 为构建容器加上 --cpus=2.5 --memory=4g 与 NODE_OPTIONS=--max-old-space-size=3072 杜绝 Exit 137 OOM 杀库，并配合 2.5 Gbps Fair-Use 免超额费端口每晚执行 pg_dump | zstd | rclone 异地备份。

## 关键步骤清单
1. **初始化 Debian 12 Swap、BBR 与 Docker 配置**: 创建 4 GB /swapfile 并设 vm.swappiness=10，启用 BBR，提前写入 /etc/docker/daemon.json 配置 20m x 3 日志限额与 172.80.0.0/16 网段池。
2. **安装 Coolify v4 或 Dokploy 并解析泛域名**: 在纯净 Debian 12 运行官方一键安装命令，将 deploy.example.com 与 *.apps.example.com 的 A 和 AAAA 记录指向服务器双栈公网 IP。
3. **在 SCP → Firewall 封堵后台原始端口**: 公网仅保留 TCP 80 与 TCP/UDP 443，SSH 限制在内网隧道访问，显式阻断 8000、3000、6001、6002 入站。
4. **限制构建内存峰值并配置夜间 R2 异地备份**: 配置 --cpus=2.5 --memory=4g 与 NODE_OPTIONS=--max-old-space-size=3072，大版本更新前打 €0 SCP 快照，启用每日 pg_dump | zstd | rclone 定时任务。

---

自托管 **Coolify v4** 或 **Dokploy** 的稳定性考验几乎都集中在 `git push` 触发构建的那几分钟：并发 `pnpm build`、TypeScript 检查与 `zstd` 镜像层压缩会与线上 PostgreSQL、Traefik 争抢同一套内核队列。在 [Netcup RS 1000 G12.5](/zh/models/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% 免税注册指南](/zh/guides/vat-free-registration-guide/) 与 [CCP 提前 1 个月通知期与合同期末退订指南](/zh/guides/contract-and-cancellation-guide/)）。

## 1. Debian 12 宿主机初始化：4 GB Swap、BBR 与 `/etc/docker/daemon.json`

在 SCP 部署纯净 **Debian 12 (Bookworm)** 后，请**先执行以下宿主机初始化再运行面板安装脚本**，让 Docker 首次启动就加载日志轮转与无冲突网段：

```bash
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`）路由冲突：

```bash
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` 端口与容器网络）：

```bash
# 方案 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](/zh/models/rs-1000-g12-5/)（`€15.22/月`），重负载可配 [RS 2000](/zh/models/rs-2000-g12-5/) | 轻量选 [VPS 500 G12.5](/zh/models/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：

```text
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 内存保障线上请求：

```ini
# 构建期环境变量（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` 的远程存储）：

```bash
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](/zh/models/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 泛域名签发。 |

上线前可在 [容器选型与迁回计算器](/zh/tools/server-sizer/) 中核对自身服务的内存余量，或参阅 [Root-Server 独享核与 VPS 架构对比](/zh/compare/netcup-root-server-vs-vps/)，再从下方复制可用的 `#rs1` 或 `#rs2` 免月优惠码。

## 常见问题解答

### 8 GB 内存的 RS 1000 G12.5 上选 Coolify v4 还是 Dokploy？

Dokploy 控制面空闲内存更低（约 320 MB，Coolify v4 约 620 MB），底层直接初始化 Docker Swarm，在 4 GB VPS 500 或 8 GB RS 1000 上非常轻快；Coolify v4 则支持通过 SSH 挂载独立远程 Build Server、PR 预览环境以及更丰富的单键应用模板，8 GB（RS 1000）或 16 GB（RS 2000）跑起来同样充裕。

### 部署自托管 PaaS 为什么优先选 RS 1000（€15.22/月）而非 VPS 1000（€11.17/月）？

VPS 1000 G12.5 采用定频 2.0 GHz 热迁移模型的共享 EPYC vCore；RS 1000 G12.5 首年每月仅多 €4.05，但分配 4 颗物理独享 Zen 5 线程，可将构建限制在 2.5 核内，确保剩余 1.5 颗物理核以 0% Steal 稳定响应 PostgreSQL 与 Traefik。

### 绑定 HTTPS 后，SCP 防火墙必须封禁哪些默认端口？

管理面板通过 443 端口正常访问后，务必在 SCP → Firewall 显式 DROP 入站 TCP 8000（Coolify 初始端口）、TCP 3000（Dokploy 初始端口）以及 TCP 6001/6002（Coolify Soketi 实时日志与终端端口），防止外部绕过反向代理直连底层服务。

### 什么时候需要拆分构建节点或升级到 RS 2000 G12.5？

当活跃容器超过 25 个、包含重度 Rust/JVM 构建或本地 PostgreSQL/ClickHouse 数据量突破 90 GB 时，建议直接升级 RS 2000 G12.5（8 核独享 Zen 5、16 GB DDR5 ECC、256 GB NVMe，叠 #rs2 首年免税 €31.35/月），或用一台 VPS 500 G12.5（€6.94/月；新客首单叠 #5e 为 €6.52/月）单独承担构建任务。

---
Source: EUServerLab (https://euserverlab.com/zh/guides/coolify-dokploy-self-hosting-netcup-guide/) | Open Telemetry Dataset: https://euserverlab.com/benchmarks/vps-500-g12-5.json
