基于PHP的轻量级博客typecho

本文完成于 5 月中旬，发布时未在最新版本上验证；

什么是 typecho ？

Typecho 是一款基于 PHP 的博客软件，旨在成为世界上最强大的博客引擎。Typecho 在 GNU 通用公共许可证 2.0 下发布。支持多种数据库，原生支持 Markdown 排版语法，是一款轻量、高效、稳定、简洁的开源博客程序。

命令行安装

在群晖上以 Docker 方式安装。

typecho 的镜像版本比较多，例如基于 php7.4 的版本就包含了：nightly-php7.4、nightly-php7.4-apache、nightly-php7.4-cli、nightly-php7.4-fpm 这 4 个版本

因为基于 apache 的容器在老苏的低内核版本的机器上，会在初始化时出现下面的错误

Function not implemented: AH00141: Could not initialize random number generator

所以最后老苏选择了 nightly-php7.4-fpm 这个 tag 的版本，但 fpm 镜像本身未内置 web 服务器，需要依赖于 nginx 或者其他 web 服务

第一步、将下面的内容保存为 docker-compose.yml 文件

version: '3.7'services:app:image: joyqi/typecho:nightly-php7.4-fpmcontainer_name: typecho-serverrestart: alwaysvolumes:- ./www:/appenvironment:- TIMEZONE=Asia/Shanghaidepends_on:- dbdb:image: mariadb:10.6container_name: typecho-mariadbrestart: alwaysvolumes:- ./data:/var/lib/mysqlenvironment:- TZ=Asia/Shanghai- MYSQL_ROOT_PASSWORD=LHFeR2vSfiTR- MYSQL_DATABASE=typecho- MYSQL_USER=typecho- MYSQL_PASSWORD=Ls59JAqRiymLweb:image: nginxcontainer_name: typecho-nginxrestart: alwaysports:- 8812:80links:- appvolumes:- ./nginx.conf:/etc/nginx/nginx.conf:rovolumes_from:- appdepends_on:- app

• joyqi/typecho:nightly-php7.4-fpm 的说明

关于镜像 nightly-php7.4-fpm 的环境变量很多，请参考官方文档：
https://github.com/typecho/Dockerfile#environment-variables

但老苏发现设了并没有起作用，在设置向导中还是需要手工输入，所以就没用环境变量，只保留了 TIMEZONE

• mariadb:10.6 的说明

可变	值
TZ	时区设置为 Asia/Shanghai
MYSQL_ROOT_PASSWORD	数据库管理员账号的密码
MYSQL_DATABASE	数据库库名设为了 typecho
MYSQL_USER	数据库用户设为了 typecho
MYSQL_PASSWORD	数据库用户typecho 对应的密码

• nginx 的说明

本地端口	容器端口
8812	80

本地端口只要不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

第二步、将下面的内容保存为 nginx.conf 文件

worker_processes auto;error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;events {worker_connections  1024;
}http {include       /etc/nginx/mime.types;default_type  application/octet-stream;log_format  main  '$remote_addr - $remote_user [$time_local] "$request" ''$status $body_bytes_sent "$http_referer" ''"$http_user_agent" "$http_x_forwarded_for"';access_log  /var/log/nginx/access.log  main;sendfile        on;#tcp_nopush     on;# Prevent nginx HTTP Server Detectionserver_tokens   off;keepalive_timeout  65;#gzip  on;#upstream php-handler {#    server app:9000;#}server {listen 80 default_server;root /app;index index.php;access_log /var/log/nginx/typecho_access.log main;if (!-e $request_filename) {rewrite ^(.*)$ /index.php$1 last;}location / {index index.html index.htm index.php;if (!-e $request_filename) {rewrite . /index.php last;}}location ~\.php(.*)$ {fastcgi_pass   app:9000;fastcgi_index  index.php;fastcgi_param  PATH_TRANSLATED $document_root$fastcgi_path_info;fastcgi_split_path_info  ^((?U).+\.php)(/?.+)$;fastcgi_param  PATH_INFO  $fastcgi_path_info;fastcgi_param  SCRIPT_NAME $fastcgi_script_name;fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;include        fastcgi_params;}}
}

第三步、依次执行下面的命令

# 新建文件夹 typecho 和 子目录
mkdir -p /volume2/docker/typecho/{data,www}# 进入 typecho 目录
cd /volume2/docker/typecho# 将 docker-compose.yml 和 nginx.conf 放入当前目录# 一键启动
docker-compose up -d

以上文件可以在这里找到： https://github.com/wbsu2003/synology/tree/main/typecho

运行

在浏览器中输入 http://群晖IP:8812 就能看到主界面，第一次会需要设置

点 开始下一步 开始设置数据库

• 数据库适配器：默认的 Pdo_Mysql 就可以；
• 数据库前缀：默认的 typecho_ 就可以；
• 数据库地址：不能使用 localhost，要改为 docker-compose.yml 中设置的 db；
• 数据库用户名：要对应 mariadb:10.6 的环境变量 MYSQL_USER 的值；
• 数据库密码：要对应 mariadb:10.6 的环境变量 MYSQL_PASSWORD 的值；
• 数据库名：要对应 mariadb:10.6 的环境变量 MYSQL_DATABASE 的值；
• 高级选项：默认就可以，一般不需要修改；

接下来设置管理员

• 网站地址：如果局域网使用，用 IP就行，否则改为域名，例如：https://typecho.laosu.ml:444
• 用户名：根据需要自行设置；
• 登录密码：根据需要自行设置；
• 邮件地址：根据需要自行设置；

安装完成后，有两个地址选项

• 点 查看您的 Blog 或者在浏览器中输入 http://群晖IP:8812

• 点 访问您的控制面板

开始使用

发一篇文章

去首页看看

中文软件，功能很容易上手

参考文档

Typecho Official Site
地址：https://typecho.org/

typecho/typecho: A PHP Blogging Platform. Simple and Powerful.
地址：https://github.com/typecho/typecho

typecho/Dockerfile: Docker Image packaging for Typecho
地址：https://github.com/typecho/Dockerfile