clewdr

环境要求

• 支持 Linux、macOS、Windows、Android，架构为 x86_64 或 aarch64
• 下载发布包需要能访问 GitHub Releases（curl 或浏览器）
• 使用 Docker 方式需具备 Docker 环境，镜像支持 linux/amd64 与 linux/arm64
• 默认监听 8484 端口，本机或容器需开放该端口

安装与启动步骤

1. 1下载解压发布包

   在 Releases 下载对应平台压缩包，命名形如 clewdr-<os>-<arch>.zip；解压后给二进制加执行权限。

   curl -L -O https://github.com/Xerxes-2/clewdr/releases/latest/download/clewdr-linux-x86_64.zip
   unzip clewdr-linux-x86_64.zip
   chmod +x clewdr

   复制

2. 2运行二进制

   直接启动单个静态可执行文件，程序常驻运行，控制台会打印管理员密码，请立即记录。

   ./clewdr

   复制

3. 3打开管理界面

   浏览器访问本机 8484 端口，用控制台打印的管理员密码登录后台进行后续配置。

4. 4改用 Docker 部署

   官方镜像方式启动；必须把数据目录挂载到 /etc/clewdr，否则每次重建容器都会重新生成密码。

   docker run -d --name clewdr -p 8484:8484 -v clewdr-data:/etc/clewdr ghcr.io/xerxes-2/clewdr:latest

   复制

5. 5用环境变量设密码

   任意配置项都可用「大写 + CLEWDR_ 前缀」作为环境变量传入，适合自动化部署时自行指定密码。

   docker run -d --name clewdr -p 8484:8484 -v clewdr-data:/etc/clewdr -e CLEWDR_PASSWORD=your-api-password -e CLEWDR_ADMIN_PASSWORD=your-admin-password ghcr.io/xerxes-2/clewdr:latest

   复制

6. 6查看生成的密码

   若没有自己设置密码，可从容器日志里过滤出包含 Password 的行，读取自动生成的管理员密码。

   docker logs clewdr | grep Password

   复制

关键配置

如何确认成功

浏览器打开 http://127.0.0.1:8484 能显示管理页面，并用控制台或 docker logs 中打印的管理员密码成功登录。

常见问题

注意事项

• Docker 方式不挂载 /etc/clewdr 时，容器每次重建都会丢失自动生成的密码。
• 镜像内已关闭更新检查，因为容器中的镜像无法替换自身二进制。
• 任意配置项都能写成大写并加 CLEWDR_ 前缀的环境变量，布尔值支持 true/false、yes/no、on/off、1/0（大小写不敏感）。
• 程序为单个静态可执行文件，体积约 15MB、内存占用通常小于 10MB、启动时间小于 1 秒。