package
Version:
v0.2.0
Opens a new window with list of versions in this module.
Published: Oct 27, 2026
License: AGPL-3.0
Opens a new window with license information.
Imports: 8
Opens a new window with list of imports.
Imported by: 0
Opens a new window with list of known importers.
Documentation
¶
Package logfile 提供节点侧的日志文件写入:按大小滑动的单文件窗口 + 有界尾部读取。
为什么不用 logrotate:节点(精简镜像)不保证装了 logrotate,而 xray.log 是 xray 输出的
唯一副本(agent 用管道接它的 stdout/stderr)。大小滑动只需要「读尾部 + 重写一次」,
且不改变运维心智——永远只有一个文件,grep 到的就是最近的日志。
滑动语义:写入使体积超过上限时,保留文件尾部一半(按行首对齐)再继续追加;
上限 0 = 不限制(回到旧行为)。日志时效性强,故不压缩、不留多份。
SlideNow 把文件裁剪到 maxBytes 的一半(按行首对齐),返回释放字节数。
供 CLI(xray-agent logs --vacuum)与 agent 内部共用;文件小于保留量时不动。
Tail 读取文件末尾 n 行(有界:只从尾部按 1MB 窗口回溯,不整文件进内存)。
手动模式下没有常驻 agent 时也走这里。
Sliding 按大小滑动的日志 writer(并发安全,可直接塞进 io.MultiWriter)。
Open 打开(必要时创建)日志文件;存量文件超过上限时先裁剪一次。
Vacuum 立即裁剪到窗口内,返回释放的字节数。
Write 追加日志;超过上限先滑动。写失败不改变滑动状态(宁可超限也别丢日志)。
Source Files
¶
Click to show internal directories.
Click to hide internal directories.