老僧博客 半亩方塘,种点代码,也种点生活

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 证书这几件事都顺手补齐了。折腾的意义大概就在这儿:每一次被迫重建环境,都会逼你把以前"能用就行"的地方收拾利索。

如果你也在迁移过程中卡住,欢迎留言交流,我尽量把当时排查的思路说清楚。

本文为老僧博客原创文章,采用知识共享署名 4.0 国际许可协议(CC BY 4.0)授权。欢迎转载,请注明出处与原文链接。

评论(2)

远方的猫2026-07-03 11:26
坑二太真实了,Nginx 和 PHP 两层都要改,我上次就只改了一层,来回折腾了一晚上。
老周2026-07-05 15:02
数据库时间批量纠正那段笑出声,同款经历。已收藏,下次迁移照着来。