服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- df -h 目标日志路径才显示该文件所在文件系统的容量;用文件大小与可用的打开句柄信息识别写入者,不要默认数据库或所有日志都有问题。
- 由面板管理的 Xray 配置应优先通过面板降低 loglevel;把 debug 长期开启会增加日志写入量。
- 若必须释放空间,只能在确认文件身份、非符号链接且已保存需要的证据后,清理一个确定的 .log 文件。
- Nezha Agent 缺失会影响监控可见性,但不能仅据此认定它导致了 Xray 日志增长。
先判断是磁盘耗尽还是某个文件异常增长
Linux 服务出现 database or disk is full、写入失败或面板数据库报错时,先看根分区和具体目录占用。空间紧张可能来自日志、数据库、备份、容器层或临时文件;不能因为错误出现在 x-ui,就直接删除数据库或清空整个日志目录。Xray 的详细日志在持续流量下可能不断增加,单个文件达到数 GiB 也不能自动证明文件可安全删除。
先用 df 判断文件系统空间,再用 du、stat 和 lsof 分别查目录大小、单个文件字节数和当前写入进程。诊断日志中可能包含用户 IP、域名、入站信息或代理元数据;不要把完整日志、配置或诊断包放到公开工单。
只读确认日志所在文件系统、Xray 日志和写入者
下面命令只读取系统状态。先把 LOG 替换为已确认的 Xray 日志路径,再用 df -h 查看该文件所在的挂载文件系统,并检查文件大小、类型和打开句柄。只查看 df -h / 可能漏掉单独挂载的数据盘或日志分区。目录统计可能较慢;如果 x-ui 使用其他数据目录,应按服务实际配置核对,不要反复扫描整块磁盘。
若 lsof 显示 Xray 正在写该文件,通过服务管理界面检查当前日志级别和配置归属。若 lsof 未安装,这组检查不会识别写入进程;不要为此安装新工具,可使用系统已有的进程查看器或服务日志,无法确认时就保持“写入者未确认”。若日志所在文件系统仍显示空间紧张而该文件很小,再检查其他目录或已删除但仍打开的文件,不要扩大截断范围。
检查文件系统和单个日志文件
shLOG='/usr/local/x-ui/REPLACE_WITH_CONFIRMED_LOG.log'
test -f "$LOG" && test ! -L "$LOG" || exit 1
df -h "$LOG"
stat -c '%s %n' -- "$LOG"
if command -v lsof >/dev/null 2>&1; then
lsof "$LOG"
else
printf 'lsof is not installed; this check cannot identify open writers without another existing process viewer\n'
fi
先降低日志详细度,避免继续快速增长
若 Xray 配置由 x-ui 或其他面板生成,通过该面板检查日志级别并在不需要持续诊断时选择较低详细度,例如 warning;不要直接改写面板生成的运行配置文件。具体菜单名称和允许值会随面板与核心版本变化,应以当前管理界面和 Xray 文档为准。保留原值、保存配置备份,并确认是否会重启 Xray 或短暂中断代理连接。
降低级别可以减少后续日志量,但不会自动缩小已经写入的大文件。若排查必须临时启用 debug,给任务设置明确结束时间,并在诊断完成后恢复常规级别;同时检查磁盘可用空间和日志文件增速。不要以无限期 debug、定时清空所有日志或未经验证的通用 logrotate 配置代替容量管理。
需要释放空间时,只处理一个已核实的日志文件
截断日志会不可逆地丢失该文件当前内容。先判断内容是否还需要用于安全调查、故障分析或合规留存;若需要,先复制到权限受控且空间足够的独立存储,并确认副本可读取。随后再次核对准确路径、文件大小和符号链接状态。不要对 /var/log、/usr/local/x-ui 或整个日志树运行通配清理,也不要清理数据库、配置文件或订阅文件。
下面命令只接受 x-ui 目录下一个明确命名的普通 .log 文件,并将其缩至零字节。运行前将占位符替换为实际日志名,确认内容无需保留,并先检查目标文件所在的文件系统及前述安全条件。截断没有简单回滚;只有事先保存的副本可恢复原内容。操作后再次检查同一日志路径所在文件系统的可用空间和 Xray 状态。
选择性清空一个已确认日志文件
shLOG='/usr/local/x-ui/REPLACE_WITH_CONFIRMED_LOG.log'
case "$LOG" in /usr/local/x-ui/*.log) ;; *) echo 'Refusing path outside x-ui log files'; exit 1;; esac
test -f "$LOG" && test ! -L "$LOG" || { echo 'Refusing non-regular or symlink path'; exit 1; }
stat -c '%s %n' -- "$LOG"
truncate -s 0 -- "$LOG"
df -h "$LOG"
恢复后检查服务、空间和监控
清理后从服务面板确认 Xray 状态,并查看目标日志文件所在文件系统的可用空间。控制观察一段时间,判断选定日志是否继续快速增长;若继续,检查日志级别、请求量、配置与重复错误,不要反复清空文件。若截断后文件停止接收数据,检查面板是否轮转或重新创建日志路径。
主机监控服务未运行会减少磁盘告警和可见性,但它和日志产生原因是两项独立检查。若 Nezha Agent 缺失,应单独核实其服务状态、授权配置和告警接收;不能把安装 Agent 当作修复 Xray 日志的办法。避免在没有备份和服务维护窗口时重启整台主机。
完成条件与不可回滚范围
操作后确认日志所在文件系统的可用空间符合需要、Xray 正常运行、日志级别适合诊断且文件增长可控。数据库恢复写入只说明空间压力有所缓解,不代表旧日志内容得到保留;如果没有副本,已截断内容无法恢复。
若不确定某文件由哪个进程写入、它是否是有效日志、路径是否为符号链接,或服务实际由哪个面板管理,就停止清理并先确认所有者。Xray 版本、面板目录和日志命名各不相同;本文路径仅是需替换的示例位置,不是所有安装的标准位置。
资料来源
常见问题
Xray 日志很大,可以直接删除整个 x-ui 目录吗?
不可以。目录中可能包含运行配置、数据库、证书或其他服务数据。先确认单个日志文件和写入者,再按需要保留证据或只处理该文件。
降低 loglevel 会释放已经占用的空间吗?
不会。它主要减少后续日志量;已有文件需要另外评估是否保留以及怎样处置。
可以用 truncate 清空所有 .log 文件吗?
不要批量清理。先识别一个确切的日志文件,评估证据保留要求并确认路径不是符号链接。清空后只有事先保存的副本可恢复内容。
Nezha Agent 停止会导致 Xray 日志写满吗?
不能仅凭 Agent 停止得出这个因果结论。它会影响监控可见性;应分别检查 Xray 日志级别、实际写入进程和监控服务。