系统级守护进程配置：systemd/launchd/NSSM实现Docuum自动运行

系统级守护进程配置：systemd/launchd/NSSM实现Docuum自动运行

【免费下载链接】docuumDocuum performs least recently used (LRU) eviction of Docker images. 🗑️项目地址: https://gitcode.com/gh_mirrors/do/docuum

Docuum是一款轻量级Docker镜像LRU（最近最少使用）清理工具，能够自动管理Docker镜像存储，防止磁盘空间被大量未使用的镜像占用。本文将详细介绍如何通过systemd（Linux）、launchd（macOS）和NSSM（Windows）三种主流守护进程工具实现Docuum的自动运行配置，让你的Docker环境保持高效整洁。

Linux系统：使用systemd配置Docuum自动运行

systemd是现代Linux系统的标准初始化系统，通过其服务管理功能可以轻松实现Docuum的后台运行和开机自启。

1. 准备系统服务文件

Docuum项目已提供预配置的systemd服务文件，路径为：service_configs/docuum.service。该文件包含以下关键配置：

[Unit] Description=Docuum After=docker.service Wants=docker.service [Service] Environment='THRESHOLD=10 GB' ExecStart=/usr/local/bin/docuum --threshold ${THRESHOLD} Restart=on-failure [Install] WantedBy=multi-user.target

2. 安装服务文件

将服务文件复制到系统服务目录并设置权限：

sudo cp service_configs/docuum.service /etc/systemd/system/ sudo chmod 644 /etc/systemd/system/docuum.service

3. 配置清理阈值

编辑服务文件修改THRESHOLD环境变量，设置Docker镜像存储的最大容量限制（支持GB/MB单位）：

sudo nano /etc/systemd/system/docuum.service

4. 启用并启动服务

sudo systemctl daemon-reload sudo systemctl enable docuum --now

5. 验证服务状态

sudo systemctl status docuum

macOS系统：使用launchd实现后台运行

launchd是macOS系统的原生服务管理工具，通过plist配置文件可以实现Docuum的自动启动和后台运行。

1. 获取plist配置文件

项目提供的macOS配置文件路径为：service_configs/local.docuum.plist，主要配置内容包括：

<key>Label</key> <string>local.docuum</string> <key>Program</key> <string>/usr/local/bin/docuum</string> <key>ProgramArguments</key> <array> <string>/usr/local/bin/docuum</string> <string>--threshold</string> <string>10 GB</string> </array> <key>StandardOutPath</key> <string>/var/log/docuum.log</string> <key>StandardErrorPath</key> <string>/var/log/docuum.log</string>

2. 安装配置文件

将plist文件复制到用户LaunchAgents目录：

cp service_configs/local.docuum.plist ~/Library/LaunchAgents/

3. 修改配置参数

使用文本编辑器修改阈值设置和日志路径：

nano ~/Library/LaunchAgents/local.docuum.plist

4. 加载并启动服务

launchctl load ~/Library/LaunchAgents/local.docuum.plist launchctl start local.docuum

5. 设置开机自启

launchctl enable user/$(id -u)/local.docuum

Windows系统：通过NSSM配置服务

Windows系统没有原生的类似systemd的服务管理工具，推荐使用NSSM（Non-Sucking Service Manager）来配置Docuum作为系统服务运行。

1. 安装NSSM工具

从NSSM官网下载适合Windows版本的二进制文件，并添加到系统PATH环境变量中。

2. 打开管理终端

以管理员身份运行Windows Terminal或命令提示符。

3. 启动NSSM配置界面

nssm install Docuum

4. 配置服务参数

在NSSM配置窗口中设置以下参数：

• Path: 选择Docuum可执行文件路径（通常为C:\Program Files\Docuum\docuum.exe）
• Arguments:--threshold 10 GB（设置清理阈值）
• Log on: 选择"Local System account"并勾选"Allow service to interact with desktop"
• Startup type: 设置为"Automatic"

5. 完成安装并启动服务

点击"Install service"完成安装，然后通过以下命令启动服务：

nssm start Docuum

服务管理与故障排查

查看服务运行状态

• Linux:systemctl status docuum
• macOS:launchctl list | grep docuum
• Windows:nssm status Docuum

查看日志文件

• Linux:journalctl -u docuum
• macOS:tail -f /var/log/docuum.log
• Windows: 日志文件路径可在NSSM配置中指定

调整清理阈值

根据实际需求修改服务配置中的--threshold参数，单位支持GB（如20 GB）或MB（如5000 MB），建议设置为系统磁盘容量的20-30%。

总结

通过本文介绍的三种方法，你可以在任何主流操作系统上实现Docuum的自动运行配置。无论是Linux的systemd、macOS的launchd还是Windows的NSSM，都能确保Docuum在后台持续监控并清理Docker镜像，帮助你维护一个高效、整洁的Docker环境。根据你的操作系统选择合适的配置方法，只需简单几步即可完成设置，让Docuum为你的Docker存储管理保驾护航。

【免费下载链接】docuumDocuum performs least recently used (LRU) eviction of Docker images. 🗑️项目地址: https://gitcode.com/gh_mirrors/do/docuum