基于PHP的轻量级博客typecho

在这里插入图片描述

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

什么是 typecho ?

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

命令行安装

在群晖上以 Docker 方式安装。

typecho 的镜像版本比较多,例如基于 php7.4 的版本就包含了:nightly-php7.4nightly-php7.4-apachenightly-php7.4-clinightly-php7.4-fpm4 个版本

因为基于 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-fpm
    container_name: typecho-server
    restart: always
    volumes:
      - ./www:/app
    environment:
      - TIMEZONE=Asia/Shanghai
    depends_on:
      - db
 
  db:
    image: mariadb:10.6
    container_name: typecho-mariadb
    restart: always
    volumes:
      - ./data:/var/lib/mysql
    environment:
      - TZ=Asia/Shanghai
      - MYSQL_ROOT_PASSWORD=LHFeR2vSfiTR
      - MYSQL_DATABASE=typecho
      - MYSQL_USER=typecho
      - MYSQL_PASSWORD=Ls59JAqRiymL
      
  web:
    image: nginx
    container_name: typecho-nginx
    restart: always
    ports:
      - 8812:80
    links:
      - app
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    volumes_from:
      - app
    depends_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 Detection
    server_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