服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Geo 数据缺失可以让 PassWall 的 Xray 分流核心启动失败,但不代表 Xray 二进制一定损坏。
- 只检查活动配置引用的目录、文件名、非空状态、overlay 空间和明确的 run-test 错误。
- 精简 GeoIP 仅适用于规则确实只引用 cn 与 private 的配置;其他类别必须使用覆盖完整规则的资源。
- 低内存路由器不得同时运行活动核心与额外 Xray 配置校验进程;无线与 UDP 需另行验收。
先确认是数据文件问题而不是核心缺失
PassWall 启动日志若明确报告缺少 Geo 规则,且当前 Xray 配置测试在加载 GeoIP/GeoSite 类别时提示数据文件不存在,应先检查活动核心读取的数据文件。Xray 进程退出不等于二进制缺失;配置、资源路径和规则类别都可能阻止核心启动。
某个历史组合中的故障环境为 ImmortalWrt 24.10.5、PassWall 25.12.16-r1 与 Xray 25.2.21。该版本记录仅界定这次问题的适用范围,不代表当前推荐或其他固件兼容;先记录设备本机实际版本。
核对活动配置路径、文件与可用空间
从当前 PassWall Xray 运行配置确认 GeoIP 与 GeoSite 文件的实际目录和文件名。OpenWrt/ImmortalWrt 某些构建会使用 /usr/share/v2ray/geoip.dat 与 geosite.dat,但自定义路径或核心类型可能不同;不要只因默认目录没有文件就向错误位置复制。
检查文件是否存在且非空,读取 PassWall 启动日志中的第一条 Geo 错误,并确认 overlay 剩余空间足以容纳最终资源。历史场景中完整 GeoIP 与 GeoSite 数据大于设备当时的可用空间;重复下载完整文件可能导致写入失败或影响系统。
只读检查 Geo 文件、日志和 overlay 空间
shGEODATA_DIR='REPLACE_WITH_DIRECTORY_FROM_ACTIVE_XRAY_CONFIG'
for name in geoip.dat geosite.dat; do
if test -s "$GEODATA_DIR/$name"; then printf '%s present\n' "$name"; else printf '%s missing-or-empty\n' "$name"; fi
done
logread | grep -iE 'geodata|geoip|geosite|passwall|xray' | tail -n 80
df -k /overlay
根据实际规则选择完整或精简 GeoIP
先查看 PassWall 分流配置中实际引用的所有 geoip:<类别> 与 geosite:<类别>。只有当 GeoIP 类别仅为 cn 和 private 时,精简的 cn/private GeoIP 数据才覆盖现有配置;若还使用其他国家或地区类别,就必须选择包含这些类别的匹配资源。GeoSite 数据仍需覆盖配置引用的域名类别。
文件名要与核心预期一致:精简 GeoIP 文件安装后应以核心读取的 geoip.dat 名称出现,域名规则资源应是相匹配的 geosite.dat。下载来源、发布版本和校验和要与设备上的 PassWall/Xray 版本对应;不要使用未核验的镜像或把旧资源当作当前数据。
校验文件后再安装到活动目录
从资源维护者的可信发布页选择覆盖活动规则类别的 GeoIP 与 GeoSite 资源,在本地暂存文件并分别核对 SHA-256。下面的命令不会下载文件,也不会修改 PassWall 更新地址。只有当前规则确实只使用 cn 和 private GeoIP 类别、且该发布说明提供匹配的精简资源更新项时,才在 LuCI 中单独记录并更新 global_rules.geoip_url;不要修改 GeoSite 更新项、节点或 DNS。
写入前通过 LuCI 有序停止 PassWall,确认没有活动 Xray 核心并保留有线 LAN 管理入口。确认活动数据目录存在、overlay 空间足以容纳旧文件备份和临时文件。替换所有路径与发布校验和后再运行命令;它会先校验来源、备份已有普通文件,再安装并校验目标文件。若任一来源或哈希未经核实,不要运行。
校验并安装已核验的 GeoIP 与 GeoSite 文件
shset -eu
GEODATA_DIR='REPLACE_WITH_DIRECTORY_FROM_ACTIVE_XRAY_CONFIG'
GEOIP_SOURCE='REPLACE_WITH_VERIFIED_GEOIP_FILE'
GEOSITE_SOURCE='REPLACE_WITH_VERIFIED_GEOSITE_FILE'
EXPECTED_GEOIP_SHA256='REPLACE_WITH_PUBLISHED_GEOIP_SHA256'
EXPECTED_GEOSITE_SHA256='REPLACE_WITH_PUBLISHED_GEOSITE_SHA256'
verify_sha256() {
printf '%s %s\n' "$2" "$1" | sha256sum -c -
}
test -d "$GEODATA_DIR"
for name in geoip.dat geosite.dat; do
target="$GEODATA_DIR/$name"
staged="$GEODATA_DIR/.$name.new"
if [ -L "$target" ] || { [ -e "$target" ] && [ ! -f "$target" ]; }; then
printf 'Target is not a regular file; stop: %s\n' "$target" >&2
exit 1
fi
if [ -e "$staged" ] || [ -L "$staged" ]; then
printf 'Temporary path already exists; stop: %s\n' "$staged" >&2
exit 1
fi
done
verify_sha256 "$GEOIP_SOURCE" "$EXPECTED_GEOIP_SHA256"
verify_sha256 "$GEOSITE_SOURCE" "$EXPECTED_GEOSITE_SHA256"
BACKUP_DIR="/root/passwall-geodata-$(date +%Y%m%d-%H%M%S)"
mkdir -m 700 "$BACKUP_DIR"
[ ! -e "$GEODATA_DIR/geoip.dat" ] || cp -p "$GEODATA_DIR/geoip.dat" "$BACKUP_DIR/"
[ ! -e "$GEODATA_DIR/geosite.dat" ] || cp -p "$GEODATA_DIR/geosite.dat" "$BACKUP_DIR/"
install -m 0644 "$GEOIP_SOURCE" "$GEODATA_DIR/.geoip.dat.new"
install -m 0644 "$GEOSITE_SOURCE" "$GEODATA_DIR/.geosite.dat.new"
verify_sha256 "$GEODATA_DIR/.geoip.dat.new" "$EXPECTED_GEOIP_SHA256"
verify_sha256 "$GEODATA_DIR/.geosite.dat.new" "$EXPECTED_GEOSITE_SHA256"
mv -f "$GEODATA_DIR/.geoip.dat.new" "$GEODATA_DIR/geoip.dat"
mv -f "$GEODATA_DIR/.geosite.dat.new" "$GEODATA_DIR/geosite.dat"
避免低内存设备并发启动 Xray
在低内存路由器上,Xray run -test 也会创建校验进程。若 PassWall 主核心仍在运行,同时启动配置测试可能耗尽内存并被 OOM 杀死;因此先通过 LuCI 有序停止 PassWall,并确认没有 Xray 核心运行,再只执行一次配置测试。测试失败时保留错误输出,不要并发重试或批量结束进程。
只有当设备版本支持该命令形式、运行配置路径已确认且没有活动 Xray 时,才运行以下校验。通过后再从 PassWall 管理界面单独启动服务一次,观察唯一预期核心与日志;不要手工再启动第二个 Xray 实例。
若配置测试失败或启动后仍异常,先在同一 PassWall 设置中把 global_rules.geoip_url 恢复为记录的原值,再按备份目录逐个还原 Geo 文件;原先不存在的文件只删除本次新增的对应文件。不要清空整个 Geo 数据目录或恢复其他路由配置。
仅还原 GeoIP 与 GeoSite 文件
shset -eu
GEODATA_DIR='REPLACE_WITH_DIRECTORY_FROM_ACTIVE_XRAY_CONFIG'
BACKUP_DIR='REPLACE_WITH_BACKUP_DIRECTORY_CREATED_ABOVE'
for name in geoip.dat geosite.dat; do
if [ -e "$BACKUP_DIR/$name" ]; then cp -p "$BACKUP_DIR/$name" "$GEODATA_DIR/$name"; else rm -f "$GEODATA_DIR/$name"; fi
done
按客户端与协议范围完成验收
修复后先确认配置测试通过、PassWall 只运行预期核心、监听端口正确且日志不再报告 Geo 文件缺失。再从有线 LAN 客户端验证一条国内直连 TCP 请求和一条经代理的海外 TCP 请求,分别确认路由结果与实际目标响应;需要固定出口验证时使用授权目标。
历史验证只覆盖有线 LAN 的国内 TCP 直连与国外 TCP 代理。它不证明无线客户端、UDP 转发或长期稳定性。更新 global_rules.geoip_url 前须确认资源类别与现有规则相符;若增加其他 GeoIP 类别,重新选择覆盖范围匹配的数据并检查存储。保留网络、DHCP、防火墙、无线与 PassWall 备份,不要把含凭据的配置或日志公开。
资料来源
常见问题
没有 Xray 进程是否说明核心二进制丢失?
不一定。若日志和配置测试明确指向 Geo 文件不存在,应先检查活动配置路径、数据资源和引用类别,再判断是否需要处理二进制。
精简 cn/private GeoIP 可以用于所有规则吗?
不能。只有规则引用的 GeoIP 类别确实限于 cn 与 private 时才适用;其他类别需要相应覆盖范围的数据文件。
PassWall 正在运行时可以并发执行 Xray run-test 吗?
低内存路由器上不要这样做。先有序停止 PassWall 并确认无活动核心,再仅运行一次配置校验,以降低 OOM 风险。