PuppyIP 资源中心
网络与连接排错 10 分钟 发布于 2026-11-17

ImmortalWrt PassWall Xray 缺少 GeoIP/GeoSite 文件:核对数据与内存

PassWall Xray 日志提示 GeoIP 或 GeoSite 文件缺失时,先核对实际配置路径与存储空间,再验证匹配的数据文件。

ImmortalWrt PassWall Xray GeoIP geosite.dat

服务对象与地域限制

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 空间

sh
GEODATA_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
ImmortalWrt/OpenWrt shell 只读检查。替换为活动 Xray 配置中的数据目录;日志与路径可能含设备信息,分享前脱敏。

根据实际规则选择完整或精简 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 文件

sh
set -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"
仅在维护窗口、已备份原 UCI 值、可用有线 LAN 管理入口且 PassWall 已有序停止时执行。替换为可信发布中的文件路径、活动目录与校验和;脚本会拒绝符号链接/非普通目标和已有临时路径。先确认 overlay 空间;来源或哈希未确认时不要运行。

避免低内存设备并发启动 Xray

在低内存路由器上,Xray run -test 也会创建校验进程。若 PassWall 主核心仍在运行,同时启动配置测试可能耗尽内存并被 OOM 杀死;因此先通过 LuCI 有序停止 PassWall,并确认没有 Xray 核心运行,再只执行一次配置测试。测试失败时保留错误输出,不要并发重试或批量结束进程。

只有当设备版本支持该命令形式、运行配置路径已确认且没有活动 Xray 时,才运行以下校验。通过后再从 PassWall 管理界面单独启动服务一次,观察唯一预期核心与日志;不要手工再启动第二个 Xray 实例。

若配置测试失败或启动后仍异常,先在同一 PassWall 设置中把 global_rules.geoip_url 恢复为记录的原值,再按备份目录逐个还原 Geo 文件;原先不存在的文件只删除本次新增的对应文件。不要清空整个 Geo 数据目录或恢复其他路由配置。

仅还原 GeoIP 与 GeoSite 文件

sh
set -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 资源。另在 PassWall 设置中手动恢复记录的原 global_rules.geoip_url。

按客户端与协议范围完成验收

修复后先确认配置测试通过、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 风险。