本文主要内容
本文介绍了如何使用 Docker 部署 Typecho，特别是解决官方 Docker 镜像导致部分主题不可使用的问题，如 Cuckoo 主题。

拉取官方代码#

克隆仓库并进入目录：

1
git clone https://github.com/typecho/Dockerfile && cd Dockerfile

修改 Dockerfile 和初始化脚本：
- 打开 Dockerfile.base 并将最后几行改为：
```
1
VOLUME /typoche
2
WORKDIR /typoche
```
- 修改 scripts/init.sh 文件，替换所有 /app 关键字为 typecho。
修改构建脚本：
- 编辑 build.sh，设置 Docker Hub 用户名：
  Terminal window
```
1
dockerhub_username=${dockerhub_username:-your_username}
```
执行构建命令：
Terminal window
```
1
./build.sh -v 1.2.1 -p 8.0 -o alpine fpm
```
- v: Typecho 版本，参考官方 Release Tag
- p: PHP 版本
- o: 镜像平台，这里使用 alpine
- fpm: 使用 fpm，如需 apache 版本，改为 php

部署流程#

配置 PostgreSQL 数据库#

创建并编辑 docker-compose.yaml：

1
cd .. && mkdir pgsql && cd pgsql && nano docker-compose.yaml

添加以下内容：

1
services:
2
  db:
3
    image: postgres:17-alpine
4
    restart: unless-stopped
5
    networks:
6
      - network
7
    environment:
8
      POSTGRES_USER: ${DB_USER}
9
      POSTGRES_PASSWORD: ${DB_PASSWORD}
10
      POSTGRES_DB: ${DB_NAME}
11
    volumes:
12
      - ./data:/var/lib/postgresql/data
13
      - ./docker-entrypoint-initdb.d:/docker-entrypoint-initdb.d
14
    healthcheck:
15
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
16
      interval: 5s
17
      timeout: 5s
18
      retries: 5
19
networks:
20
  network:
21
    driver: bridge

创建环境变量文件 .env：
Terminal window
```
1
nano .env
```
添加如下配置：
.env
```
1
DB_USER=xxxx
2
DB_PASSWORD='xxxxxx'
3
DB_NAME=typecho-blog
```
启动数据库服务：
Terminal window
```
1
docker compose up -d
```

配置 Typecho#

设置 Typecho 服务：

1
cd .. && mkdir typecho && cd typecho && nano docker-compose.yaml

配置如下内容：

1
services:
2
  typecho:
3
    image: your_dockerhub_username/typecho:1.2.1-php8.0-fpm-alpine
4
    restart: unless-stopped
5
    networks:
6
      - pgsql_network
7
    ports:
8
      - 65021:9000
9
    environment:
10
      TYPECHO_SITE_URL: https://blog.useforall.com
11
      TYPECHO_DB_ADAPTER: Pdo_Pgsql
12
      TYPECHO_DB_HOST: db
13
      TYPECHO_DB_PORT: 5432
14
      TYPECHO_DB_USER: ${DB_USER}
15
      TYPECHO_DB_PASSWORD: ${DB_PASSWORD}
16
      TYPECHO_DB_DATABASE: ${DB_NAME}
17
      TYPECHO_USER_NAME: ${ADMIN_USER}
18
      TYPECHO_USER_PASSWORD: ${ADMIN_PASSWORD}
19
      TYPECHO_USER_MAIL: ${ADMIN_MAIL}
20
      TYPECHO_INSTALL: 1
21
      TIMEZONE: Asia/Shanghai
22
      MEMORY_LIMIT: 200M
23
    volumes:
24
      - ./typecho:/typecho
25
networks:
26
  pgsql_network:
27
    external: true

创建 .env 文件以设定环境变量：
Terminal window
```
1
nano .env
```
添加以下信息：
.env
```
1
DB_USER=xxxx
2
DB_PASSWORD='xxxx'
3
DB_NAME=typecho-blog
4
ADMIN_USER=lim
5
ADMIN_PASSWORD='xxxx'
6
[email protected]
```
注意
DB_* 配置项必须与 PostgreSQL 数据库中的一致，否则无法连接数据库。
启动 Typecho 服务：
Terminal window
```
1
docker compose up -d
```

配置 Nginx Proxy Manager#

设置 Nginx 代理服务：

1
cd .. && mkdir npm && nano docker-compose.yaml

添加如下内容：

1
services:
2
  app:
3
    network_mode: bridge
4
    image: 'jc21/nginx-proxy-manager:latest'
5
    restart: unless-stopped
6
    ports:
7
      - 80:80
8
      - 65020:81
9
      - 443:443
10
    volumes:
11
      - ./data:/data
12
      - ./letsencrypt:/etc/letsencrypt
13
      - ../typecho/typecho:/typecho:ro

启动 Nginx Proxy Manager：
Terminal window
```
1
docker compose up -d
```

配置 Nginx 使用 SSL 证书：

Nginx 配置：

1
root /typecho;
2
index index.php;
3
location / {
4
    try_files $uri $uri/ /index.php?$query_string;
5
}
6
location ~ \.php(.*)$ {
7
    fastcgi_pass   172.17.0.1:65021;
8
    fastcgi_index  index.php;
9
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
10
    include fastcgi_params;
11
}

Docker部署Typecho并使用Nginx Proxy Manager反代

拉取官方代码#

部署流程#

配置 PostgreSQL 数据库#

配置 Typecho#

配置 Nginx Proxy Manager#

评论区

目录