NAS 与运维

AllinSSL:自动申请与部署 HTTPS 证书

  • 0 次阅读
  • 0 条评论
文章摘要

AllinSSL 把证书申请、续期与部署任务放在一个管理界面中。使用 DNS 验证时,可在没有公网 HTTP 入口的环境中申请域名证书,再把证书交付给 NAS、反向代理或其他服务。 证书任务完成申请与续期,部署任务再把证书交给目标服务。两步分开记录,能发现已签发但服务仍用旧证书的情况。 适合多个域名与服务的证书维护。DNS 凭据只授权所需记录,部署账号只写入目标位置。

项目介绍

AllinSSL 把证书申请、续期与部署任务放在一个管理界面中。使用 DNS 验证时,可在没有公网 HTTP 入口的环境中申请域名证书,再把证书交付给 NAS、反向代理或其他服务。

证书任务完成申请与续期,部署任务再把证书交给目标服务。两步分开记录,能发现已签发但服务仍用旧证书的情况。

适合多个域名与服务的证书维护。DNS 凭据只授权所需记录,部署账号只写入目标位置。

核心功能

功能 作用与使用方式
ACME 申请 为域名取得证书
DNS 验证 完成 TXT 校验
续期计划 提前更新证书
部署动作 写入文件并重载
结果通知 记录申请与交付状态

界面展示

AllinSSL 官方项目配图

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

AllinSSL 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 allinssl/allinssl
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 先列出域名、DNS 服务商和证书要部署到的位置。为 DNS 验证创建仅能修改目标域名记录的 API 凭据,避免使用整个云账号的主密钥。
  2. 按仓库当前安装文档启动服务,设置独立管理账号。添加 ACME 账号和 DNS 服务商配置,先用测试环境验证域名授权链路。
  3. 创建证书任务,填写实际域名;泛域名证书与根域名应分别按需求加入。等待 TXT 记录验证成功后检查证书 SAN、签发者和有效期。
  4. 新增部署任务,将证书链和私钥写入目标服务要求的位置,并执行目标服务的重载操作。最后从浏览器或 TLS 客户端检查对外提供的证书是否确实更新。
  5. 开启到期提醒,保留至少一次续签和部署日志;证书申请成功但部署失败时,应单独排查目标权限与重载命令。

首次使用与操作检查

先用测试环境完成签发,再部署到测试服务,从外部检查实际证书有效期。

续签成功但访问仍过期时查目标路径与重载。私钥与部署凭据单独备份,不放入公开配置。

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 许可 保留来源与许可;图片只做等比例缩小和压缩。