Ubuntu 24.04中手动部署Typecho
在新安装的 VirtualBox 虚拟机 Ubuntu 24.04 中手动部署 Typecho,需先配置必要的运行环境。本文简要记录了所需依赖的安装过程实操。
目录
- 安装 Apache Web 服务器
- 安装 PHP
- 安装 Typecho 并填写登录信息
安装依赖
- PHP 7.2 以上
- Mysql, PostgreSQL, SQLite 任意一种数据库支持,并在 PHP 中安装了相关扩展
- CURL 或者 Socket 扩展支持
- mbstring 或者 iconv 扩展支持
首先更新软件源,不需要 upgrade 。
sudo apt update1. 安装 Apache Web 服务器
执行命令:
sudo apt install apache2如果虚拟机是桌面版本,使用虚拟机里的浏览器访问http://localhost或127.0.0.1即可。后面的两个 Note 不用看了,不过针对服务器版本的操作也能用。
如果虚拟机是服务器版本,在宿主机浏览器访问虚拟机的 IP 地址,如图,Apache 未安装好则显示 无法访问 或 拒绝连接 。(新装的虚拟机里没有安装其他 Web 服务器)

Note1
关于如何查看虚拟机的本机 IP (Windows11):Windows设置-网络和Internet-高级网络设置(在最底部),
看到有一项的小字标着VirtualBox Host-Only Ethernet Adapter,点开-查看其他属性-IPv4地址。Note2
如果虚拟机网络配置是网络地址转换,需要设置端口转发,在VirtualBox中:右键当前虚拟机-弹出菜单点击设置-选择网络选项卡-点击端口转发
协议TCP,主机端口80,子系统端口80。点击确定即可。
Apache2 很快就安装好,浏览器页面显示:
Apache2 安装好后会启动并自动设置为开机自启,这里附上手动设置的命令:
sudo systemctl enable apache2 # 开机自启
sudo systemctl disable apache2 # 取消开机自启
sudo systemctl start apache2 # 启动
sudo systemctl stop apache2 # 停止2. 安装 PHP
直接安装当前可用的最新版本:
# php-sqlite3:轻量级数据库支持
# php-mbstring:多字节字符串的处理
sudo apt install php php-sqlite3 php-mbstring
php -v # 检查安装情况
# 下面这个命令会把 php 安装信息输出到 Apache 服务器的 “网站” 目录里
echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php浏览器打开 虚拟机IP/info.php,显示如图,能够渲染PHP页面说明 Apache 对 PHP 的支持已经自动设置好了。
附上手动设置 PHP 支持的命令:
sudo a2enmod php8.3
sudo systemctl restart apache23. 安装 Typecho
3.1 下载
官方下载页面链接
在虚拟机中执行:
cd ~
pwd # 在自己的home目录中操作
wget https://github.com/typecho/typecho/releases/latest/download/typecho.zip
sudo apt install unzip # 安装zip解压工具
mkdir t && cd t # 准备解压到临时文件夹
unzip ../typecho.zip如果 wget 执行失败,可能是网络原因,可以使用加速网站。复制上面的原链接输入到加速网站输入框,把 wget 后面的链接替换为转换后的链接即可。
3.2 安装
Apache2 默认/var/www/html为网站根目录,前面 Apache2 对 PHP 的支持已经配置好,直接把解压好的 Typecho 放入网站根目录即可。
# 转移原来的 index.html 和 info.php,也可以直接删除
sudo mv /var/www/html/* ~
cd ~/t/ # 进入刚刚解压的位置
sudo cp -r * /var/www/html/
# 转移目录所有权,以便服务器可以对该目录做修改
sudo chown -R www-data:www-data /var/www/html
# www-data 是 Apache2 的所属组(Linux权限管理相关)刷新浏览器页面(虚拟机IP见前面安装 Apache Web 服务器的部分)
点击下一步按钮并按要求填写信息即可。
数据库配置
创建管理员账号
安装成功
总结
Apache2
- 安装 Apache Web 服务器,并验证其运行状态(通过 http://localhost 或虚拟机 IP 访问)
PHP 环境配置
- 安装 PHP 及必要扩展(php-sqlite3、php-mbstring),满足 Typecho 的最低依赖要求。
- 通过 phpinfo() 页面验证 Apache 与 PHP 的集成是否正常。
Typecho 安装
- 从 GitHub 下载最新稳定版 Typecho(可配合 GitHub 加速服务解决国内下载慢的问题)。
- 将解压后的文件部署到 Apache 默认网站目录 /var/www/html。
- 设置目录权限为 www-data 用户组,确保 Web 服务器具备写入能力。
- 通过浏览器完成图形化安装向导:配置数据库(SQLite 示例)、创建管理员账号等。
其他
- 若遇 GitHub 下载失败,推荐使用如 gh-proxy.com 等代理加速服务。
- Apache 和 PHP 模块通常在安装后自动启用,但必要时可通过 a2enmod 手动启用。
- 初始安装成功后会显示自动生成的密码,建议立即登录后台修改。
