Typecho 跑进 Docker,我踩了三个坑
上个月把博客从裸机环境迁到了 Docker,原因是服务器上其他项目也都是容器部署的,想统一管理。本以为 Typecho 这种轻量程序迁移很轻松,结果折腾了一整个下午,前前后后踩了三个坑。写下来给打算迁移的朋友做个参考。
最终的 docker-compose
先贴最终能用的配置,再说坑:
services:
typecho:
image: joyqi/typecho:nightly-php8.2-apache
container_name: typecho
restart: always
ports:
- "127.0.0.1:8300:80"
volumes:
- ./usr:/app/usr
- ./config:/app/config
environment:
- TZ=Asia/Shanghai
mysql:
image: mysql:8.0
container_name: blog-mysql
restart: always
environment:
MYSQL_ROOT_PASSWORD: "换成你自己的密码"
MYSQL_DATABASE: typecho
TZ: Asia/Shanghai
volumes:
- ./mysql-data:/var/lib/mysql
注意我把 8300 端口只绑在了 127.0.0.1 上,外面再用 Nginx 反代,这样容器本身不直接暴露到公网,图个安心。
坑一:官方镜像缺 fileinfo 扩展
迁完后台一打开就报错,提示缺少 fileinfo 扩展。这个扩展 PHP 8 之后默认不启用,而 Typecho 的附件上传(判断文件类型)依赖它。官方镜像不带,需要自己补装。
解决的办法是自己写一个 Dockerfile,在官方镜像基础上编译安装:
FROM joyqi/typecho:nightly-php8.2-apache
RUN docker-php-ext-install fileinfo \
&& docker-php-ext-enable fileinfo
编译一次要几分钟,耐心等。顺便提醒:如果你用的 PHP 版本低于 8.0,可能还要装 mbstring 和 mysqli,方法一样。
坑二:上传大附件被 Nginx 拦下
程序跑起来之后,我想传几张照片试试,结果超过 1MB 的图片全都 413 报错。一开始以为是 Typecho 的配置问题,查了半天才发现是 Nginx 默认的 client_max_body_size 只有 1m,在反代配置里加上一行就好:
location / {
proxy_pass http://127.0.0.1:8300;
client_max_body_size 20m;
}
同时记得把 PHP 的 upload_max_filesize 和 post_max_size 也调大,两层都要放开才行。我一度只改了 Nginx,结果换了个地方继续报错,这俩得一起改。
坑三:时区不对,文章时间差八小时
迁移完发现新发的文章时间戳比实际时间晚了 8 个小时——典型时区问题。容器默认是 UTC,国内访问差了整整一个时区。解决办法是在 docker-compose 里给容器加上 TZ=Asia/Shanghai 环境变量(我上面的配置里已经写了),同时确认 PHP 的 date.timezone 也设置正确。
这里有个隐蔽的点:改完时区之后,之前用 UTC 时间写入的旧文章时间不会自动变,需要到数据库里统一刷一遍,或者干脆用 UPDATE typecho_contents SET modified = modified + INTERVAL 8 HOUR 之类的语句批量纠正。别问我怎么知道的。
最后
迁移完成后的那几天,我盯着新环境总觉得不踏实,于是把备份、监控、自动续期 HTTPS 证书这几件事都顺手补齐了。折腾的意义大概就在这儿:每一次被迫重建环境,都会逼你把以前"能用就行"的地方收拾利索。
如果你也在迁移过程中卡住,欢迎留言交流,我尽量把当时排查的思路说清楚。
评论(2)