lllllllillllllillll/dweebui Docker 镜像 - 轩辕镜像

dweebui 服务 Docker Compose 配置说明

以下是用于快速部署 dweebui 服务的 Docker Compose 配置说明，包含服务运行所需的基础设置、环境配置及资源映射等内容，方便直接上手使用。

一、服务基本信息

容器标识与镜像

• 容器名称：固定为 dweebui，便于识别和管理。
• 运行镜像：使用 lllllllillllllillll/dweebui 官方镜像，无需手动构建。
• 重启策略：设置为 unless-stopped（除非手动停止容器，否则服务异常退出后会自动重启），保障服务稳定性。

二、环境变量配置

服务运行依赖以下环境变量，需根据实际需求调整：

• PORT: 8000：指定容器内服务监听端口，需与下方端口映射保持一致。
• SECRET: MrWiskers：服务安全密钥（默认值，生产环境需修改为自定义复杂密钥，避免安全风险）。

三、端口映射

• 映射规则：宿主机 8000 端口映射到容器内 8000 端口（即 8000:8000）。
• 作用：通过宿主机 8000 端口可直接访问 dweebui 服务（若宿主机 8000 端口被占用，可修改宿主机端口部分，如 8080:8000）。

四、数据持久化与权限配置

1. 配置数据持久化

• 通过命名卷 dweebui（在 volumes 模块单独定义）挂载到容器内 /app/config 目录，用于持久化保存服务配置文件（服务重启或重建容器后，配置数据不会丢失）。

2. 容器与引擎通信配置

服务需通过以下方式与容器引擎（Docker/Podman）通信，根据宿主机运行环境选择：

• Docker 环境：默认挂载宿主机 Docker socket（/var/run/docker.sock:/var/run/docker.sock），使容器能调用 Docker 引擎 API（如管理其他容器）。
• Podman 环境：若使用 Podman 运行容器，需将上述 Docker socket 挂载路径替换为 Podman socket（取消注释 #- /run/podman/podman.sock:/var/run/docker.sock 并删除 Docker 相关挂载）。

五、网络设置

• 网络名称：使用独立网络 dweebui_net（在 networks 模块定义），避免与宿主机其他网络冲突。
• 网络驱动：采用 bridge 驱动（Docker 默认网络模式），容器通过桥接网络与宿主机及其他容器通信。

六、使用说明

1. 启动服务

在配置文件（docker-compose.yml）所在目录执行以下命令启动服务：

bash
docker-compose up -d

2. 注意事项

• 安全密钥修改：将 SECRET 字段值从 MrWiskers 改为自定义复杂密钥（如包含大小写字母、数字和特殊符号的字符串）。
• 容器引擎适配：根据宿主机实际使用的容器引擎（Docker/Podman），保留对应 socket 挂载配置，删除或注释另一种配置。
• 端口冲突检查：启动前确认宿主机 8000 端口未被占用（可通过 netstat -tuln | grep 8000 检查），冲突时修改宿主机端口映射（如 8080:8000）。

通过以上配置，可快速部署一个稳定运行的 dweebui 服务，且数据、网络、权限均按标准容器化方案管理，适合开发或生产环境使用。