callowaysutton/ptero-external-ip

Ptero External IP 镜像文档

镜像概述

Ptero External IP 是一个用于为Pterodactyl或Docker容器分配公网IP的工具镜像。通过检测容器环境变量SERVER_IP，自动配置iptables规则实现SNAT（源网络地址转换），将容器流量从指定的外部IP路由出去。外部IP需预先分配在主机上。

核心功能与特性

• 自动IP分配：当其他Docker容器设置SERVER_IP环境变量（值为外部IP）时，自动配置iptables规则
• iptables管理：在nat表中创建名为SERVER_IP的链，集中管理相关路由规则
• 锁文件支持：通过挂载/run/xtables.lock确保主机与容器间iptables锁定一致性，防止竞争条件导致容器启动失败

使用场景

适用于需要为Docker容器（尤其是Pterodactyl面板管理的游戏服务器或应用容器）分配特定公网IP的场景，需确保指定的外部IP已绑定到主机网络接口。

使用方法

前置要求

• 确保主机上存在/run/xtables.lock文件（非目录），用于iptables锁定
• 外部IP需预先分配并配置在主机网络接口上

Docker部署命令

bash
docker run --detach \
  --net=host \                  # 使用主机网络命名空间，便于管理iptables
  --cap-add=NET_ADMIN \         # 添加网络管理权限
  --cap-add=NET_RAW \           # 添加原始网络数据包处理权限
  --volume /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker socket以监控容器
  --volume /run/xtables.lock:/run/xtables.lock \        # 挂载iptables锁文件
  callowaysutton/ptero-external-ip

容器配置

为需要分配外部IP的容器设置SERVER_IP环境变量，值为已分配给主机的外部IP：

bash
# 示例：启动一个带外部IP的容器
docker run --env SERVER_IP=192.168.1.100 your-image

注意事项

• 锁文件创建：若主机不存在/run/xtables.lock，需手动创建（touch /run/xtables.lock），避免Docker错误创建为目录
• 权限要求：容器需要NET_ADMIN和NET_RAW capabilities以管理iptables规则
• 网络模式：必须使用--net=host模式以确保iptables规则对主机网络生效