近期证书信任链及运行时高危漏洞集中披露:eMudhra 弱密钥事件使 8 张中间 CA 私钥可被毫秒级还原,但该事件本身无统一 CVE,下游修复分散于 Go(CVE-2026-111943)与 Firefox(CVE-2026-113470);与此同时,PHP 两个 CVSS 9.2 的未认证 RCE 是当前最高紧迫性独立威胁;Node.js 存在多项高危 TLS 绕过与 RCE;DigiCert、TrustAsia 事件均无 CVE 编号,Nginx 无自身漏洞但证书链配置风险被放大。
这套架构在 2026 年 10 月已整体过期或存在风险:
PHP 8.1(blessing-skin-server):EOL,且存在 CVE-2026-109618 / CVE-2026-109619 两个未认证 RCE(CVSS 9.2)。
Node.js 22(Janus):仍是 LTS,但需升级到含 CVE-2026-111497(Brotli RCE)、CVE-2026-105483 / CVE-2026-106069(TLS 主机名绕过)修复的最新 22.x。
MariaDB 10.6:已于 2026-07-06 EOL,不再有安全修复,应计划迁移。
Redis:若镜像 digest 较旧,可能受 CVE-2026-23479 / CVE-2026-25243(认证后 RCE)影响;未设密码则风险更高。
Nginx:若版本 ≤1.30.5 / ≤1.31.6,可能受 CVE-2026-15176 / CVE-2026-97205 / CVE-2026-93479(CVSS 9.2,崩溃/RCE)影响。
关于 Blessing Skin 的容器化部署,请移步 https://github.com/Dainsleif233/skin-docker。
以下内容编写于 2026 年 3 月。
2022 年 1 月发布的 Blessing Skin 最新 Release v6.0.2 最高支持到 PHP 8.1,而后者已在 2025 年 12 月 31 日停止支持。在 2026 年部署一个四年未发 Release 的皮肤站是相当麻烦的。
bs-community 没有提供皮肤站的 Docker 镜像,不过可以自己写一个。
Janus 是 Blessing Skin Server 的外挂 Yggdrasil Connect 服务端。但是 Janus 不是开箱即用的,需要手动构建。
为搭建外挂 Janus 的皮肤站,我们要使用 Blessing Skin Server,Janus,Redis,MariaDB 四个服务,分别构建 Docker 镜像并通过 Docker Compose 进行编排,此后进行各种配置,最后验证服务状态。
本文撰写于 2026 年 3 月 11 日,大修于 3 月 13 日。
长文预警! 本文源代码字符数 14000+,覆盖了从环境准备、Docker 镜像编写、服务配置到验证的全过程。不过有相当的篇幅是配置文件和命令行操作。
教程面向全新建站,尚未验证迁站方法。
你应该能够在 Linux Bash 上进行基本操作(如运行命令、文件操作、权限管理、简单文件编辑等),以下工作几乎只需要在命令行和浏览器中完成。
首先确保服务器上安装了 Docker 并能正常使用 docker 或 docker-compose 命令拉取镜像和构建容器。常用 Nginx 作为反向代理。
创建以下工作目录,命名仅作示例:
./ # bs-docker
├── skin/ # Blessing Skin Server
├── janus/ # Janus
├── redis/ # Redis 数据目录 (Docker 卷挂载)
├── mariadb-data/ # MariaDB 数据目录 (Docker 卷挂载)
├── docker-compose.yml # Docker Compose 配置
在 ./skin/ 下载并解压 Blessing Skin Server 的发行版(v6.0.2)。
在 ./janus/ 克隆 Janus 的源码。这里使用 MySQL/MariaDB 版本的 Janus。
# 以下 Janus 项目均使用此次 Commit 的仓库
# https://github.com/bs-community/janus/commit/e027ee68fb22b0ec1ed6778d1b701bd084348edb
sudo git clone https://github.com/bs-community/janus.git .
以下 Docker 配置只是“能用”水平,做参考用,请按需修改。
在 ./skin/Dockerfile 中写入:
# 使用 PHP 8.1 Apache 镜像
FROM php:8.1-apache-bookworm
# 可选镜像加速
# RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list.d/debian.sources
RUN apt-get update
RUN apt-get install -y ca-certificates git unzip libpng-dev libjpeg-dev
COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
RUN install-php-extensions gd zip pdo_mysql redis bcmath exif intl
WORKDIR /app
ENV APACHE_DOCUMENT_ROOT /app/public
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf
RUN a2enmod rewrite headers
EXPOSE 80
在 ./janus/Dockerfile 中写入:
# 使用 Node.js 22 镜像构建 Janus
FROM node:22-bookworm AS builder
WORKDIR /app
# 可选镜像加速
# RUN npm config set registry https://registry.npmmirror.com
COPY package*.json ./
RUN npm install
COPY . .
RUN npx prisma generate
RUN npm run build
FROM node:22-bookworm-slim
WORKDIR /app
# 可选镜像加速
# RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list.d/debian.sources
RUN apt-get update
RUN apt-get install -y ca-certificates git unzip libpng-dev libjpeg-dev
RUN apt-get update
RUN apt-get install -y openssl
RUN rm -rf /var/lib/apt/lists/*
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
COPY --from=builder /app/prisma ./prisma
EXPOSE 3000
CMD ["node", "dist/main.js"]
注意在这里设置数据库的 ROOT_PASSWORD,USER 和 PASSWORD,务必在初始化时修改!
后续在 Blessing Skin 和 Janus 的配置中需要使用这些值。
./docker-compose.yml:
services:
db:
image: mariadb:10.6
container_name: skin_db
restart: always
environment:
# 这是 MariaDB 的环境变量,设置 root 密码和默认数据库
# 生产环境请改用更安全的用户名和密码
MYSQL_ROOT_PASSWORD: # 设置 root 密码
MYSQL_DATABASE: # 设置默认数据库名,例如 blessingskin
MYSQL_USER: # 设置普通用户,例如 username
MYSQL_PASSWORD: # 设置普通用户密码,例如 secret
volumes:
- ./mariadb-data:/var/lib/mysql
- /etc/localtime:/etc/localtime:ro
redis-server:
image: redis:alpine
container_name: skin_redis
restart: always
command: redis-server --appendonly yes
volumes:
# 缓存数据:挂载当前目录下的 redis 文件夹
- ./redis:/data
- /etc/localtime:/etc/localtime:ro
skin:
build:
context: ./skin
dockerfile: Dockerfile
container_name: skin_app
restart: always
ports:
# 外部端口 8001 根据需要修改
- "8001:80"
volumes:
- ./skin:/app
- /etc/localtime:/etc/localtime:ro
depends_on:
- db
- redis-server
janus:
build: ./janus
container_name: skin_janus
restart: on-failure:3
ports:
# 外部端口 3001 根据需要修改
- "3001:3000"
volumes:
- ./janus/.env:/app/.env:ro
# Janus 需要访问 Blessing Skin 的 OAuth 私钥文件,挂载到容器内
# - ./skin/storage/oauth-private.key:/app/oauth-private.key:ro
depends_on:
- db
从 ./skin/.env.example 复制一份到 ./skin/.env,并编辑(添加或修改对应选项):
# --- 基础配置 ---
APP_ENV=production
APP_DEBUG=false
APP_FALLBACK_LOCALE=zh-CN
# --- 数据库配置 ---
# 使用 MySQL/MariaDB,对接 Docker 的 db 服务
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
# 填写 docker-compose.yml 中设置的用户名、密码、数据库名
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
# 注意这里没有设置数据表前缀
DB_PREFIX=
# --- 密码加密方式 ---
PWD_METHOD=BCRYPT
APP_KEY=
# --- 邮件配置(此处略) ---
# --- 缓存与会话 ---
# 使用 Redis 作为缓存和会话存储,对接 Docker 的 redis-server 服务
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
# --- Redis 配置 ---
REDIS_CLIENT=phpredis
REDIS_HOST=redis-server
REDIS_PASSWORD=null
REDIS_PORT=6379
# --- 插件配置 ---
PLUGINS_DIR=
PLUGINS_URL=
# 可选插件市场地址
PLUGINS_REGISTRY=https://moeluoyu.xyz/api/plugins-dist/registry_zh_CN.json
# 后续还要补充 Client ID
# PASSPORT_PERSONAL_ACCESS_CLIENT_ID=
本文的 Janus 配置经过一次大修。详见花絮。
Janus 需在 ./janus/prisma/ 下复制一份 schema.prisma.example,命名为 schema.prisma。检查 ./skin/.env 中的数据表前缀 DB_PREFIX,在本文里为空,不用修改 schema.prisma。
以下全部使用 example.com 为示例地址,实际部署时请替换为你的域名。
把 Janus 部署到子目录 https://example.com/api/janus,要对源码做几处修改。以下路径 /api/janus 根据实际情况修改。
修改 ./janus/src/app.controller.ts 的 getHello(Line 35):
// @All("/*")
// getHello(@Req() req: Request, @Res() res: Response): Promise<void> {
// return this.appService.callback(req, res);
// }
@All("/{*path}")
getHello(@Req() req: Request, @Res() res: Response): Promise<void> {
req.url = req.originalUrl.replace("/api/janus", "");
return this.appService.callback(req, res);
}
修改 ./janus/src/main.ts,在 app.enable('trust proxy');(Line 27)后添加:
app.enable('trust proxy');
// 新增一行 setGlobalPrefix
app.setGlobalPrefix('api/janus');
await app.listen(process.env.PORT ?? 3000);
修改 ./janus/src/oidc-provider.service.ts 的 url(Line 127):
// url(ctx, interaction) {
// const prompt = interaction.prompt;
// return `/interaction/${interaction.uid}`;
// },
url(ctx, interaction) {
const prompt = interaction.prompt;
return `/api/janus/interaction/${interaction.uid}`;
},
然后从 ./janus/.env.example 复制一份到 ./janus/.env,并编辑:
PORT="3000"
DB_HOST=db
DB_PORT=3306
# 填写 docker-compose.yml 中设置的用户名、密码、数据库名
DB_USERNAME=
DB_PASSWORD=
DB_NAME=
# 根据实际 Nginx 配置调整
ISSUER="https://example.com/api/janus"
BS_SITE_URL="http://example.com"
# 后续要填入创建的个人访问客户端的 ID
SHARED_CLIENT_ID=
# 其他配置项保持默认即可
附 Nginx 结构示例。
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://127.0.0.1:8001; # Blessing Skin 服务
}
location /api/janus {
proxy_pass http://127.0.0.1:3001; # Janus 服务
}
}
在此之前解决一下权限问题。Blessing Skin 需要对一些目录有写权限,否则浏览器访问站点时会提示 Permission denied。最直接的方法是给宿主机运行目录下的文件夹设置成 777。
当然也可以给目录设置所属用户组(如果有):
sudo chown -R www-data:www-data .
接下来正式构建和启动容器。
这里先构建和启动 Blessing Skin、MariaDB 和 Redis,后续再启动 Janus:
# 可以指定构建/启动的容器
sudo docker-compose build skin db redis-server
sudo docker-compose up -d skin db redis-server
# sudo docker-compose build
# 有的平台指令略有不同,需要用 docker compose
如果遇到拉取镜像问题请自行解决。
生成应用密钥与数据库迁移。使用 docker-compose exec 直接在宿主机上执行命令来操作容器内的环境。若执行的命令为 bash,则会进入容器的交互式终端。
# 生成应用密钥
sudo docker-compose exec skin php artisan key:generate
# 运行数据库迁移,创建表结构
sudo docker-compose exec skin php artisan migrate --seed
生成 OAuth 密钥对。
sudo docker-compose exec skin php artisan passport:keys --force
# 确认私钥为 PKCS#8 格式,见 Janus Wiki
# 如有必要再修改权限
# sudo docker-compose exec skin chown www-data:www-data storage/oauth-private.key
登录网页,配置管理员,安装 Yggdrasil-Connect 插件。以修改过的 Union 插件为例。
https://mc.sjtu.cn/union。Yggdrasil-Connect 并启用。测试访问 https://example.com/api/yggdrasil 应该能看到 JSON 返回。https://example.com/api/janus,提交修改。# 运行修复命令,确保数据库中有正确的 UUID 表结构
# sudo docker-compose exec skin php artisan yggc:fix-uuid-table
# 创建客户端,--owner 后面填写某个用户的 ID,替换掉 <user_id>
sudo docker-compose exec skin php artisan yggc:create-personal-access-client --owner=<user_id>
执行后返回的内容可能有 Client ID: 1,记下这个 ID,后续配置 Blessing Skin 和 Janus 时需要用到。
去 ./skin/.env 中编辑 PASSPORT_PERSONAL_ACCESS_CLIENT_ID:
PASSPORT_PERSONAL_ACCESS_CLIENT_ID=1
去插件管理禁用和启用一次 Yggdrasil-Connect 插件。
然后配置 OAuth2 回调地址:
<user_id> 对应账户,进入高级功能 → OAuth2 应用。1 的那个)。https://example.com/yggc/client/public(将域名替换为你的实际地址),保存。编辑 ./docker-compose.yml,找到 Janus 服务的 volumes 部分,取消注释密钥挂载行:
volumes:
- ./janus/.env:/app/.env:ro
# Janus 需要访问 Blessing Skin 的 OAuth 私钥文件,挂载到容器内
- ./skin/storage/oauth-private.key:/app/oauth-private.key:ro # 取消这一行的注释
还记得 Janus 之前没构建过吗?现在停止所有容器,准备构建 Janus 镜像并启动容器:
sudo docker-compose down
编辑 ./janus/.env 文件,再次确认以下配置,记得填上 Client ID:
# 数据库配置(使用 Docker 服务名)
# 与 docker-compose.yml 一致
DB_HOST=db
DB_PORT=3306
DB_USERNAME=
DB_PASSWORD=
DB_NAME=
# 根据实际配置调整
ISSUER="https://example.com/api/janus"
BS_SITE_URL="https://example.com"
# 修改为上一步获取的 Client ID
SHARED_CLIENT_ID=<client_id>
同时再去 ./docker-compose.yml 中确认 Janus 挂载了密钥。
现在构建 Janus 镜像并启动 Janus 和数据库容器:
sudo docker-compose build janus
sudo docker-compose up -d janus db
Janus 使用 Prisma 管理数据库,需要手动执行迁移创建表结构。
以下命令建议手动输入。
# 进入 Janus 容器
sudo docker-compose exec janus bash
# 查看迁移文件列表(确认有 0_init 等目录)
ls -la prisma/migrations/
# 可能的输出:
# total 20
# drwxr-xr-x 4 root root 4096 Mar 11 13:37 .
# drwxr-xr-x 3 root root 4096 Mar 13 06:51 ..
# drwxr-xr-x 2 root root 4096 Mar 11 13:37 0_init
# drwxr-xr-x 2 root root 4096 Mar 11 13:37 20250618204012_init_janus
# -rw-r--r-- 1 root root 123 Mar 11 13:37 migration_lock.toml
# 标记初始迁移为已应用(解决数据库已存在表的冲突)
npx prisma migrate resolve --applied 0_init
# 对于本教程 v6.0.2 的 blessing skin,不要应用 20250618204012_init_janus
# 应用所有迁移,创建表结构
npx prisma migrate deploy
# 再次生成 Prisma 客户端
npx prisma generate
# 退出容器
exit
重启全部容器:
sudo docker-compose down
sudo docker-compose up -d
检查 OAuth2 回调地址是否设置为 https://example.com/yggc/client/public。
检查 OpenID 提供者标识符,应当是你的 Janus 地址,例如 https://example.com/api/janus。如果为空,则填写并保存,禁用并重新启用 Yggdrasil Connect 插件,必要时再重启容器。
检查:
./skin/.env 的 PASSPORT_PERSONAL_ACCESS_CLIENT_ID./janus/.env 中的 SHARED_CLIENT_ID是否正确设置为之前创建的个人访问客户端的 ID。
访问 Yggdrasil 和 OpenID 配置端点,应该能看到正确的 JSON 返回:
# 其实可以使用浏览器访问
curl -i https://example.com/api/yggdrasil
curl -i https://example.com/api/janus/.well-known/openid-configuration
Yggdrasil 端点的返回示例:
{
"meta": {
"serverName": "...",
"implementationName": "Yggdrasil Connect for Blessing Skin by LittleSkin",
"implementationVersion": "6.1.0-0.3.1",
"links": {
"homepage": "https://example.com",
"register": "https://example.com/auth/register"
},
"feature.non_email_login": true,
"feature.openid_configuration_url": "https://example.com/api/janus/.well-known/openid-configuration"
},
"skinDomains": [
"example.com"
],
"signaturePublickey": "-----BEGIN PUBLIC KEY-----\n......\n-----END PUBLIC KEY-----\n"
}
OpenID 以下端点的 URL 都应该有 /api/janus(另外有正确的shared_client_id)例如:
{
"authorization_endpoint": "https://example.com/api/janus/auth",
"device_authorization_endpoint": "https://example.com/api/janus/device/auth",
"issuer": "https://example.com/api/janus",
"jwks_uri": "https://example.com/api/janus/jwks",
"token_endpoint": "https://example.com/api/janus/token",
"userinfo_endpoint": "https://example.com/api/janus/userinfo",
"shared_client_id": "1"
}
https://example.com/api/yggdrasil。可选:修改前端样式
可以修改前端页面以统一授权页面风格。仍然参见这篇文章。
至此,Docker 部署 Blessing Skin 和外挂 Janus 已经完成。
花絮:
.env 中配置了地址,但是 CACHE_DRIVER 等选项根本没写 redishttps://example.com/api/janus/.well-known/openid-configuration 时除了 issuer 以外的 URL 都是没有子目录 /api/janus 的
Access-Control-Allow-Origin: *, *docker-compose.yml 数据库缺省配置填了形如 <skin_user> 的占位符,其中疑似尖括号引起解析导致连接数据库失败20250618204012_init_janus,不要应用这个迁移rm -rf 然后重新部署反正代码和人有一个能跑就行。
参见