技术选型

• 前端模板：Shiro
• 后端服务：Mix Space
• 反向代理：Caddy（支持自动 HTTPS 证书申请）
• 域名和服务器均在腾讯云上
• docker compose部署

部署步骤

1. 进行域名备案，如果不备案腾讯云dns会劫持域名解析，同时也会让caddy的自动申请证书功能失败
2. docker compose先部署caddy和mix space服务，进入后台管理界面对网站进行基础配置，特别是此配置，然后再部署shiro服务；也可三个服务一起部署，但是在后台配置完成前，一定不要访问前端服务 (原因下文会讲)

遇到的问题

caddy无法自动申请证书

caddy无法申请证书，会报如下图的acme的错误，查询后发现是因为腾讯云购买的域名的dns解析为dnspod，caddy需要安装对应的dns解析插件。

参考caddy的官方镜像的文档 ，知道如何build加入dnspod组件的镜像，重新build一个定制镜像即可，这是dnspod 需要的插件

Dockerfile如下：

[object Object]

也可以使用我已经build好的镜像chen1yuan2/caddy-dnspod:2.9.1-alpine

前端页面报【禁止访问或者API服务出现问题】的错误

在部署完三个服务后，在根据此基础设置在后台管理页面进行配置之前就访问了shiro前端页面，会出现这个issue提到的错误

通过翻源码https://github.com/Innei/Shiro/blob/8a9bad3b4ffba42dc57ec0b16ccc64a2f10bf159/src/app/(app)/api.tsx#L14 发现是使用了react的cache这个api导致的，初次访问时会调用后端接口获取上文提到的配置的内容，然后把结果缓存下来，因为此函数调用没有参数，所以后续的请求都会命中react的缓存，导致获取值一直为空，即便后续在后台配置了对应配置也无用，除非重启shiro这个前端服务

caddy反代无法找到前后端服务

因为使用了3个docker compose 分别进行部署，network不通用，需要使用一个统一的network,解决方案就是需要在mix space的compose文件里声明一个网络，然后在其他两个服务的docker-compose.yaml中使用这个网络，这样才能保证三个服务之间的通信。

参考部署配置

mix space的配置

mix-space的docker-compose.yml

[object Object]

shiro的配置

shiro的docker-compose.yml

[object Object]

caddy的配置

caddy的docker-compose.yml

[object Object]

caddy的Caddyfile

[object Object]

总结

常见问题排查

扩展阅读

1. MX Space 官方文档
2. Caddy 插件列表
3. Docker 网络配置指南
4. Shiro

看完了？说点什么呢