Question 1

如何阻止SWAG在每次容器重启时撤销有效的Let's Encrypt证书？

Accepted Answer

这是由于 SWAG 的证书续订脚本中存在一个错误，该脚本错误地将由 ISRG Root X2 签名的证书识别为“旧的 LE 证书”。要修复此问题，请在容器内或本地配置映射中编辑文件 `/etc/s6-overlay/s6-rc.d/init-certbot-config/run`，并将 `grep -q "ISRG Root X"` 替换为 `grep -q "ISRG Root X1"`。或者，在 certbot 中使用 `--preferred-chain` 选项强制使用不同的根证书。这可以防止不必要的吊销，并避免达到 Let's Encrypt 速率限制（每周 5 次重新签发）。

Question 2

如何修复使用 certbot-dns-azure 时出现的 'DnsManagementClient.__init__() takes 3 to 4 positional arguments but 5 were given' 错误？

Accepted Answer

此错误的原因是 certbot-dns-azure 与 azure-mgmt-dns v9.0.0 不兼容，新版本仅针对最新 API 版本且所需参数更少。解决方法：在安装插件前强制安装兼容版本：`pip install azure-mgmt-dns==8.2.0`，然后 `pip install certbot-dns-azure`。作为临时 Docker 替代方案，在 Dockerfile 中 certbot 插件安装前添加 `RUN pip install azure-mgmt-dns==8.2.0`。注意：certbot-dns-azure 插件可能从 LinuxServer SWAG 镜像中移除；建议使用通用软件包安装模块来锁定依赖版本。

Question 3

如何为 Storyteller 配置使用 LinuxServer 的 SWAG 容器的 nginx 反向代理？

Accepted Answer

使用以下nginx服务器块配置。这是用户贡献的临时解决方案，尚未合并到官方的linuxserver/reverse-proxy-confs仓库中。

```nginx
server {
    listen 443 ssl;
    listen [::]:443 ssl;

server_name storyteller.*;

include /config/nginx/ssl.conf;
    client_max_body_size 0;

location /api/v2/books/events {
        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;
        set $upstream_app storyteller;
        set $upstream_port 8001;
        set $upstream_proto http;
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;
    }

location ~* ^/_next/static/ {
        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;
        set $upstream_app storyteller;
        set $upstream_port 8001;
        set $upstream_proto http;
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;
        add_header Cache-Control "public, max-age=31536000, immutable";
    }

location ~* ^/api/v2/books/.+/(read|cover)/ {
        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;
        set $upstream_app storyteller;
        set $upstream_port 8001;
        set $upstream_proto http;
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;
        add_header Access-Control-Allow-Origin $http_origin always;
        add_header Access-Control-Allow-Methods "GET, OPTIONS" always;
        add_header Access-Control-Allow-Headers "Range, Content-Type" always;
        add_header Cache-Control "public, max-age=604800";
        proxy_force_ranges on;
    }

location / {
        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;
        set $upstream_app storyteller;
        set $upstream_port 8001;
        set $upstream_proto http;
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;
    }
}
```
确保你的Storyteller容器名称为"storyteller"，并且DNS为该子域名设置了CNAME记录。如需官方支持，请关注linuxserver/reverse-proxy-confs仓库。

docker-swag

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐