使用typecho搭建博客

0 前言

使用Wordpress+blocksy主题建站一个月左右，由于我经常使用Typora做笔记，而Wordpress对Markdown的兼容性实在是太差，插件也都不好用，进而使用typecho+joe主题重新搭建本博客网站。

2025/06/03 基于当前网站实际搭建过程更新博客内容，以便读者能够搭建类似本网站样式的网站。

1 准备工作

• 一个云服务器：

  • 用来部署网站，推荐腾讯云或阿里云
  • 普通博客网站购买轻量级即可

• 一个域名：

  • 外部访问服务器的网址，如本网站：www.washy.cn
  • 云服务器属于中国大陆区域，需要进行备案，参考域名备案的相关事项

2 云服务器环境搭建

• 在云服务器管理界面，创建操作应用实例，并安装Linux操作系统（Ubuntu或其他）
• 登陆云服务器，安装宝塔面板或同类别工具，以宝塔面板为例，前往官网查看安装命令，类似

wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && sudo bash install_panel.sh ed8484bec

• 安装完成后，根据窗口提示的外网访问网址以及账号密码，前往登陆宝塔面板界面
• 进入宝塔面板，选择LNMP一键极速安装，等待安装完成

3 初步搭建网站

• 点击左侧导航栏的【网站】-【添加站点】- 填写域名 - 创建数据库 - 提交

  • 域名：备案审核已通过的话，使用域名；还没通过的，使用公网IP
  • 数据库：选择创建

• 添加站点后，点击站点名后的【设置】，根据使用的工具修改【伪静态】

  • Nginx 默认情况

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

  • Apache

  <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
  </IfModule>

• 点击站点名后的【根目录】链接，进入站点根目录（/www/wwwroot/站点域名），删除所有文件，上传下载的typecho压缩包并解压

  • typecho官网下载链接：https://typecho.org/download
• 将解压后的所有文件剪切至站点根目录
• 浏览器输入站点域名进入typecho配置界面，点击进入下一步
• 输入数据库名称和密码，点击【提交】。数据库名称和密码可在宝塔面板左侧【数据库】页面查询

本网站基本信息设置：

• 基本 - 站点名称：愚之説
• 基本 - 站点地址：https://www.washy.cn
• 基本 - 站点描述：积极乐观的前行～
• 永久链接 - 自定义文章路径：选择【个性化定义】/{cid}.html

4 更换主题

4.1 Joe主题

• 简介：Joe原版主题，个人认为是typecho所有免费主题中最好用的
• 下载：可前往GitHub仓库下载

4.2 Joe再续前缘主题【推荐】

• 简介：Joe主题的魔改版，也是本网站使用的主题。对Joe主题进行了一些优化和改动，相较原版更符合我的审美和需求。
• 下载：自行前往作者的博客Joe再续前缘主题 - 搭建本站同款网站进行下载

4.3 主题更换方式

• 通过宝塔面板进入站点【根目录】
• 进入usr/themes文件夹，上传主题文件并解压
• 前往网站后台控制界面，点击【控制台】-【外观】，启用主题

5 安装插件

5.1 markdown插件

• TypechoMathJax【推荐】

  • 功能：自动渲染LaTeX公式
  • 下载：https://github.com/glerium/TypechoMathJax

• MarkdownParse

  • 功能：自动渲染LaTeX公式和mermaid流程图
  • 下载：https://github.com/mrgeneralgoo/typecho-markdown
  • 问题：与Joe再续前缘主题的代码块解析存在冲突

• AutoLaTeX

  • 功能：自动渲染LaTeX公式
  • 下载：https://github.com/dreamerblue/AutoLaTeX

5.2 其他插件

• SmartSpam

  • 功能：智能评论过滤插件
  • 作者：Typecho智能评论过滤插件：SmartSpam
  • 下载：SmartSpam_v2.6.0

6 补充

6.1 Wordpress数据迁移

如果之前使用Wordpress搭建过网站，需要进行数据迁移，可执行如下步骤

• 下载安装WordpressToTypecho插件，下载地址http://docs.typecho.org/_media/plugins/wordpresstotypecho.zip
• 设置数据库名称、密码等信息
• 点击左侧WordpressToTypecho选项