如何在Docker Compose中为Redmine容器配置静态路由以通过WireGuard访问私有LAN

你现在手动执行路由命令的方式确实不够高效，尤其是在自动化流水线里。我们可以通过几种方法把这个路由配置步骤集成到你的docker-compose.yml中，彻底避免手动操作：

方案1：直接修改Redmine的启动命令 #

Redmine官方镜像的默认启动流程是通过/docker-entrypoint.sh启动Rails服务器。我们可以在启动前先添加路由，再执行原命令。在你的redmine服务配置里添加command字段：

redmine:
  image: redmine:5.0.1-alpine
  cap_add:
    - NET_ADMIN
  volumes:
    - redmine-files:/usr/src/redmine/files
    - ./redmine-plugins:/usr/src/redmine/plugins
    - ./configuration.yml:/usr/src/redmine/config/configuration.yml
  ports:
    - 80:3000
  depends_on:
    - postgres
  environment:
    - 'REDMINE_DB_POSTGRES=postgres'
    - 'REDMINE_DB_DATABASE=redmine'
    - 'REDMINE_DB_PASSWORD=MySUperSecret'
    - 'REDMINE_PLUGINS_MIGRATE=true'
  # 新增启动命令，先加路由再启动Redmine
  command: >
    sh -c "ip route add 192.168.42.0/23 via 172.20.0.50 &&
           /docker-entrypoint.sh rails server -b 0.0.0.0"
  restart: unless-stopped

这里用sh -c串联两个操作：先添加目标LAN的路由，再调用原有的entrypoint启动Redmine。由于你已经给WireGuard容器指定了固定IP172.20.0.50，这个网关地址不会变动，稳定性有保障。

方案2：使用自定义Entrypoint脚本（更灵活） #

如果需要更复杂的逻辑（比如等待WireGuard连接就绪再添加路由），可以创建一个自定义entrypoint脚本：

1. 在项目根目录创建redmine-entrypoint.sh：

#!/bin/sh

# 可选：等待WireGuard容器网络可达（避免路由添加失败）
until ping -c 1 172.20.0.50 > /dev/null 2>&1; do
  echo "Waiting for WireGuard connection to be ready..."
  sleep 2
done

# 添加目标LAN的路由
ip route add 192.168.42.0/23 via 172.20.0.50

# 执行原Redmine entrypoint，传递所有启动参数
exec /docker-entrypoint.sh "$@"

2. 给脚本添加执行权限：

chmod +x redmine-entrypoint.sh

3. 修改docker-compose.yml的redmine服务，挂载脚本并设置entrypoint：

redmine:
  # 其他配置保持不变
  volumes:
    # 原有volume保留，新增脚本挂载
    - ./redmine-entrypoint.sh:/usr/src/redmine/redmine-entrypoint.sh
  entrypoint: /usr/src/redmine/redmine-entrypoint.sh

这个方案的优势是可以添加额外的检查逻辑，确保路由添加时WireGuard已经准备好，避免容器启动顺序问题导致的路由失效。

方案3：结合Healthcheck确保WireGuard就绪 #

为了进一步提升可靠性，可以给WireGuard服务添加健康检查，让Redmine只在WireGuard成功建立VPN连接后才启动：

1. 给wireguard服务添加healthcheck：

wireguard:
  image: linuxserver/wireguard
  cap_add:
    - NET_ADMIN
    - SYS_MODULE
  volumes:
    - ./wireguard-config:/config
    - /lib/modules:/lib/modules
  networks:
    default:
      ipv4_address: 172.20.0.50
  sysctls:
    - net.ipv4.conf.all.src_valid_mark=1 # for clients mode
  # 添加健康检查，验证WireGuard连接状态
  healthcheck:
    test: ["CMD", "wg", "show"]
    interval: 10s
    timeout: 5s
    retries: 5
  restart: unless-stopped

wg show命令会验证WireGuard的配置是否加载、VPN连接是否正常建立。

2. 修改Redmine的depends_on，等待WireGuard进入健康状态：

redmine:
  # 其他配置保持不变
  depends_on:
    - postgres
    wireguard:
      condition: service_healthy

这样Redmine会在WireGuard完全就绪后才启动，从根源上避免了路由添加时机过早的问题。

关键注意点 #

• 你已经给Redmine容器添加了NET_ADMIN权限，这是添加路由必须的，这个配置没问题。
• 固定WireGuard容器的IP是核心前提，否则网关地址变动会导致路由失效，你的配置已经做到了这一点。
• 如果使用自定义脚本，确保挂载路径正确，并且脚本有执行权限。

内容的提问来源于stack exchange，提问作者Bazulenkov