项目介绍
AllinSSL 把证书申请、续期与部署任务放在一个管理界面中。使用 DNS 验证时,可在没有公网 HTTP 入口的环境中申请域名证书,再把证书交付给 NAS、反向代理或其他服务。
证书任务完成申请与续期,部署任务再把证书交给目标服务。两步分开记录,能发现已签发但服务仍用旧证书的情况。
适合多个域名与服务的证书维护。DNS 凭据只授权所需记录,部署账号只写入目标位置。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| ACME 申请 | 为域名取得证书 |
| DNS 验证 | 完成 TXT 校验 |
| 续期计划 | 提前更新证书 |
| 部署动作 | 写入文件并重载 |
| 结果通知 | 记录申请与交付状态 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | allinssl/allinssl |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 先列出域名、DNS 服务商和证书要部署到的位置。为 DNS 验证创建仅能修改目标域名记录的 API 凭据,避免使用整个云账号的主密钥。
- 按仓库当前安装文档启动服务,设置独立管理账号。添加 ACME 账号和 DNS 服务商配置,先用测试环境验证域名授权链路。
- 创建证书任务,填写实际域名;泛域名证书与根域名应分别按需求加入。等待 TXT 记录验证成功后检查证书 SAN、签发者和有效期。
- 新增部署任务,将证书链和私钥写入目标服务要求的位置,并执行目标服务的重载操作。最后从浏览器或 TLS 客户端检查对外提供的证书是否确实更新。
- 开启到期提醒,保留至少一次续签和部署日志;证书申请成功但部署失败时,应单独排查目标权限与重载命令。
首次使用与操作检查
先用测试环境完成签发,再部署到测试服务,从外部检查实际证书有效期。
续签成功但访问仍过期时查目标路径与重载。私钥与部署凭据单独备份,不放入公开配置。
Docker Compose
依据官方 README 的容器示例整理。下方命令会创建 data 目录,账号使用 admin,密码与入口路径自动生成,访问地址为 http://NAS_IP:7979/所设入口路径。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/allinssl/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/allinssl /volume1/docker/allinssl/data
cd /volume1/docker/allinssl
umask 077
touch .env
if ! grep -q "^ALLINSSL_PWD=." .env; then
generated_secret=$(openssl rand -hex 32)
printf 'ALLINSSL_PWD=%s\n' "$generated_secret" >> .env
fi
if ! grep -q "^ALLINSSL_URL=." .env; then
generated_secret=$(openssl rand -hex 32)
printf 'ALLINSSL_URL=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/allinssl
所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/allinssl/.env;该文件只保留在本机。
管理账号为 admin,密码与管理入口路径分别由命令随机生成;访问 http://群晖IP:7979/ 后接上 .env 中 ALLINSSL_URL 的值。该字段是入口路径。
services:
allinssl:
image: allinssl/allinssl:latest
restart: unless-stopped
ports:
- "7979:8888"
environment:
ALLINSSL_USER: admin
ALLINSSL_PWD: "${ALLINSSL_PWD}"
ALLINSSL_URL: "${ALLINSSL_URL}"
TZ: Asia/Shanghai
volumes:
- /volume1/docker/allinssl/data:/www/allinssl/data
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 不要在脚本中写 sudo 登录密码;自动部署使用单独账号和受限命令权限。
- 私钥与 DNS API 凭据都属于敏感配置,管理页面只允许可信设备访问。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
加密备份证书配置、ACME 账号和部署任务;私钥备份限制访问,DNS 令牌支持轮换。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 allinssl/allinssl 官方仓库,按 AGPL 许可 保留来源与许可;图片只做等比例缩小和压缩。