快速搭建 Typecho 博客平台指南

要快速搭建一个博客平台其实并不难。借助腾讯云的轻量应用服务器，可以轻松部署 Typecho 博客平台。只需购买轻量应用服务器后选择 Typecho 网站模板，即可实现一键安装的体验。轻量云服务预配置了 LAMP 或 LNMP 环境，让我们不必手动设置服务器环境，十分适合快速启动和试用。

腾讯云-轻量云服务-搭建Typecho平台

在轻量云环境中快速搭建好博客平台后，我们可以简单浏览页面风格及系统配置，以确认是否符合需求。至此，一个可用的私有化部署的博客平台已经搭建完成。

但这只是开始……

使用轻量云服务搭建博客固然简便快捷，尤其对小白用户来说，仅需几步点击即可轻松完成配置。然而，作为开发者，我希望更深入了解 Typecho 的底层架构和安装过程。因此，我登录到已部署的博客服务器，准备研究这款应用的安装路径。同时，查阅了 Typecho 官方安装指南，希望进一步理解 Typecho 的构成与部署需求。

Typecho安装指南

根据文档，Typecho 的依赖环境包括以下几个主要组件：

  • PHP 7.2及以上版本（如果使用 PHP 8，建议确保 Typecho 版本支持兼容）。
  • 数据库支持：MySQL、PostgreSQL、SQLite 其中任意一种（需在 PHP 中安装相关扩展）。
  • CURL 或者 Socket 扩展。
  • mbstring 或者 iconv 扩展。

在检查云服务器配置时，发现已预装以下组件：

服务器应用清单

  • PHP：世界上最受欢迎的后端开发语言
  • MariaDB：兼容 MySQL 的数据库替代方案
  • Nginx：用于安装 Typecho 平台，并且 腾讯云支持一键配置 HTTPS 证书

这些程序被安装在用户目录下的 softwares 文件夹中，便于管理。

手动部署 Typecho

接下来，我需要下载安装包，并将文件上传至服务器的 Web 目录。这时可能会遇到一些常见问题，比如：

  1. 什么是 Web 目录？

    • 服务器 Web 目录是专为 Web 应用配置的根目录，一般情况下在 Ubuntu 系统中，路径为 /var/www/html。这里是放置 Web 应用代码的默认位置，可以通过 Nginx 或 Apache 等 Web 服务器访问。

  2. GAE/SAE/BAE/ACE 是什么？

    • GAE（Google App Engine）、SAE（新浪应用引擎）、BAE（百度应用引擎）、ACE（阿里云应用引擎）是几大厂商提供的 PaaS 平台，为 Web 应用提供预配置的运行环境，也适合快速部署 Typecho 等应用（目前阿里云上我已经找不到该服务了）。

Docker 部署 Typecho

为什么使用Docker

为了更灵活地管理应用，我决定使用 Docker 部署。首先，从 DockerHub 中搜索 php 基础镜像：Docker PHP。常见的镜像版本包括：

  • php-cli
  • php-fpm
  • php-apache
  • php-alpine

我的需求是基于 php-fpm 或 php-apache 镜像来部署 Typecho。如果追求更简单的流程，直接选择 php-apache 作为基础镜像，并挂载 /var/www/html 目录，即可快速运行 Typecho。但是为了更高的性能，我选择了 php-fpm，这样需要引入 Nginx 来处理静态资源并对接 FastCGI 协议。

使用 Nginx 和 php-fpm 协同工作

接下来，我决定将所有服务整合至 php-fpm，并前置 Nginx 以对接 FastCGI 服务。然而，经过多次测试后，我发现单独使用 php-fpm 无法直接访问应用静态资源，必须配合 Nginx 才能正常工作。因此，我在 php-fpm 镜像中安装了 Nginx，以实现完整的 PHP Web 应用环境。

在 Docker 中，推荐将 Nginx 和 php-fpm 放在不同容器中。这种做法能够实现模块化管理，便于维护和扩展。通过 Docker Compose 管理这两个容器时，可以让 Nginx 处理静态资源请求，并将动态请求反向代理到 php-fpm 容器，从而既保持了良好的性能，又确保了环境的稳定性。尽管可以将 Nginx 安装在 php-fpm 镜像中以形成单一容器，但这种方法并不符合容器化的最佳实践。

我选择将 Nginx 与 php-fpm 整合的原因在于，虽然 Nginx 可以被分离，但将 Web 应用的根目录配置到 php-fpm 所在的根目录上会导致两者共用同一个目录。这限制了 Nginx 的用途，因此我决定单独安装一个 Nginx，专门用于支持 Typecho 的运行。

Dockerfile

# 使用更新的 PHP 基础镜像
FROM php:7.4-fpm

# 更新包管理器并安装依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libpq-dev \
    zlib1g-dev \
    libzip-dev \
    zip \
    unzip \
    nginx \
    && docker-php-ext-install pdo pdo_pgsql pdo_mysql mysqli pgsql zip \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

COPY ./nginx.conf /etc/nginx/nginx.conf

EXPOSE 80

CMD service nginx start && php-fpm

nginx.conf

user  www-data;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
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;
    keepalive_timeout  65;

    server {
        listen 80;

        server_tokens off;
        server_name _;

        root /var/www/html;
        index index.php;

        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php$1 last;
        }

        location ~ .*\.php(\/.*)*$ {
            include fastcgi.conf;
            fastcgi_pass  127.0.0.1:9000;
        }

        # 禁止访问的文件或目录
        location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md) {
           return 404;
        }
    }
}

常见问题与解决方案

  1. Docker 桥接网络的 DNS 问题
    使用腾讯云轻量应用服务器的界面管理 Docker 服务时，发现页面创建容器无法直接配置网络。默认的桥接网络在 DNS 解析方面存在局限性，导致容器之间无法通过容器名进行互相访问。根据 Docker 官方文档，默认桥接网络的功能有限，不适合复杂场景。
    解决方法：使用 Docker Compose 定义一个自定义的桥接网络，自定义网络不仅支持容器名解析，还能提供更灵活的网络管理。
  2. PHP 基础镜像选择问题
    最初尝试使用 php:7.4-fpm 配合 Nginx 部署服务，但在实际运行中，发现评论功能无法正常使用。经排查，问题可能与 Nginx 的 FastCGI 配置有关。为了规避此类潜在问题，改用了 php:7.4-apache 镜像，利用其内置的 Apache Web 服务器简化配置流程，同时在 Dockerfile 中增加对多种数据库扩展的支持，以满足 Typecho 的运行需求。

Nginx-dmz 配置

Nginx 在 nginx-dmz 容器中负责将请求代理到 php-apache 容器，并支持 HTTP 和 HTTPS。以下是完整的 Nginx 配置示例。

HTTP 配置文件：default.conf

用于处理未加密的 HTTP 流量，将其代理至 php-apache 容器或重定向到 HTTPS。

server {
    listen 80;

    # 指定域名（或使用通配符 `_` 匹配所有）
    server_name example.com;

    # 将所有请求代理到 typecho 容器
    location / {
        proxy_pass http://typecho:80; # 代理到 typecho 服务

        # 传递请求头和用户信息
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 支持 WebSocket 等长连接
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

HTTPS 配置文件: default.conf

参考资料

server {
    # 自动将 HTTP 请求重定向到 HTTPS
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}
server {
    # 配置 HTTPS
    listen 443 ssl;
    server_name www.example.com example.com;

    # 指定 SSL 证书和密钥路径
    ssl_certificate     /etc/nginx/cert/example.crt;
    ssl_certificate_key /etc/nginx/cert/example.key;

    # SSL 会话和协议配置
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 5m;
    ssl_protocols       TLSv1.2 TLSv1.3;

    # 加密套件和优先级配置
    ssl_ciphers         'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:!aNULL:!MD5:!RC4';
    ssl_prefer_server_ciphers on;

    # 启用 HSTS（仅在 HTTPS 完全启用后使用）
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;

    # 将请求代理到 typecho 容器
    location / {
        proxy_pass http://typecho:80; # 代理到 typecho 服务

        # 传递请求头和用户信息
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 支持 WebSocket 等长连接
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
部署完成后，请确认证书路径及域名配置正确，然后通过 docker-compose 启动服务，验证 HTTP 和 HTTPS 的功能是否正常工作。

使用 Docker Compose 构建服务

以下是优化后的 docker-compose.yml 配置，其中包含了 Nginx、PHP-Apache 和 PostgreSQL 服务，脱敏后的配置内容如下：

version: '3.9'

services:
  nginx-dmz:
    image: nginx:latest
    container_name: nginx-dmz
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/logs:/var/log/nginx:rw                      # 日志目录挂载
      - ./nginx/cert:/etc/nginx/cert:ro                     # 证书目录挂载
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro         # 主配置文件只读挂载
      - ./nginx/conf.d:/etc/nginx/conf.d:rw                 # 其他配置文件目录挂载
    depends_on:
      - typecho
      - db
    networks:
      - app-network
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 30s

  typecho:
    image: php:7.4-apache
    container_name: typecho
    restart: always
    volumes:
      - ./typecho:/var/www/html:rw                          # 挂载 Typecho 应用目录
    networks:
      - app-network
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost"]
      interval: 10s
      timeout: 3s
      retries: 3
      start_period: 30s

  db:
    image: postgres:15-alpine
    container_name: postgres-db
    restart: always
    environment:
      POSTGRES_USER: ${PGUSER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      PGDATA: /var/lib/postgresql/data/pgdata              # 固定数据库数据路径
    command:
      - postgres
      - -c
      - max_connections=${POSTGRES_MAX_CONNECTIONS}
      - -c
      - shared_buffers=${POSTGRES_SHARED_BUFFERS}
      - -c
      - work_mem=${POSTGRES_WORK_MEM}
      - -c
      - maintenance_work_mem=${POSTGRES_MAINTENANCE_WORK_MEM}
      - -c
      - effective_cache_size=${POSTGRES_EFFECTIVE_CACHE_SIZE}
    volumes:
      - ./postgres/data:/var/lib/postgresql/data:rw        # 数据卷持久化存储
    networks:
      - app-network
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "${PGUSER}"]
      interval: 10s
      timeout: 5s
      retries: 5

networks:
  app-network:
    driver: bridge                                          # 使用自定义 bridge 网络

以下是优化后的博客内容片段，改进了语言流畅性、逻辑清晰性，并增强了可读性：

配置数据库

在按照上述步骤启动应用后，通过访问 80 或 443 端口，默认情况下可能仅支持 SQLite 数据库。如果需要使用 MySQL 或 PostgreSQL，需确保 PHP 环境安装了相应的数据库扩展（例如 pdo_mysql 或 pdo_pgsql）。

为支持多种数据库类型，可以通过修改 Dockerfile 来添加必要的 PHP 扩展，并重新构建镜像。以下是一个示例：

Dockerfile 示例

# 使用指定版本的 PHP 基础镜像
FROM php:7.4-apache

# 更新包管理器并安装所需依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libpq-dev \
    zlib1g-dev \
    libzip-dev \
    zip \
    unzip \
    nginx \
    && docker-php-ext-install \
        pdo \
        pdo_pgsql \
        pdo_mysql \
        mysqli \
        pgsql \
        zip \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

构建镜像

使用以下命令构建自定义 PHP 镜像：

docker build -t custom-php:7.4-apache -f Dockerfile .

启动数据库容器

修改自定义镜像在docker-compose中的typecho服务的镜像，并重新启动运行，然后访问 Typecho 的安装页面，完成数据库连接配置即可。

至此，Typecho 博客平台已成功搭建完成！赶快开始探索 Typecho 的更多功能吧。

标签: none

添加新评论