在新安装的 VirtualBox 虚拟机 Ubuntu 24.04 中手动部署 Typecho,需先配置必要的运行环境。本文简要记录了所需依赖的安装过程实操。

目录

  1. 安装 Apache Web 服务器
  2. 安装 PHP
  3. 安装 Typecho 并填写登录信息

安装依赖

官方安装依赖要求说明

  1. PHP 7.2 以上
  2. Mysql, PostgreSQL, SQLite 任意一种数据库支持,并在 PHP 中安装了相关扩展
  3. CURL 或者 Socket 扩展支持
  4. mbstring 或者 iconv 扩展支持

首先更新软件源,不需要 upgrade

sudo apt update

1. 安装 Apache Web 服务器

执行命令:

sudo apt install apache2

如果虚拟机是桌面版本,使用虚拟机里的浏览器访问http://localhost127.0.0.1即可。后面的两个 Note 不用看了,不过针对服务器版本的操作也能用

如果虚拟机是服务器版本,在宿主机浏览器访问虚拟机的 IP 地址,如图,Apache 未安装好则显示 无法访问拒绝连接(新装的虚拟机里没有安装其他 Web 服务器)

虚拟机网站页面暂时无法呈现

Note1
关于如何查看虚拟机的本机 IPWindows11):
Windows设置-网络和Internet-高级网络设置(在最底部)
看到有一项的小字标着 VirtualBox Host-Only Ethernet Adapter
点开-查看其他属性-IPv4地址

Note2
如果虚拟机网络配置是网络地址转换,需要设置端口转发,在VirtualBox中:
虚拟机列表
右键当前虚拟机-弹出菜单点击设置-选择网络选项卡-点击端口转发
协议TCP,主机端口80,子系统端口80。点击确定即可。

Apache2 很快就安装好,浏览器页面显示:
Apache2 Default Page
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
附上手动设置 PHP 支持的命令:

sudo a2enmod php8.3
sudo systemctl restart apache2

3. 安装 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 服务器的部分)
点击下一步按钮并按要求填写信息即可。
安装说明

数据库配置
数据库配置

创建管理员账号
创建管理员账号

安装成功
安装成功


总结

  1. Apache2

    • 安装 Apache Web 服务器,并验证其运行状态(通过 http://localhost 或虚拟机 IP 访问)
  2. PHP 环境配置

    • 安装 PHP 及必要扩展(php-sqlite3、php-mbstring),满足 Typecho 的最低依赖要求。
    • 通过 phpinfo() 页面验证 Apache 与 PHP 的集成是否正常。
  3. Typecho 安装

    • 从 GitHub 下载最新稳定版 Typecho(可配合 GitHub 加速服务解决国内下载慢的问题)。
    • 将解压后的文件部署到 Apache 默认网站目录 /var/www/html。
    • 设置目录权限为 www-data 用户组,确保 Web 服务器具备写入能力。
    • 通过浏览器完成图形化安装向导:配置数据库(SQLite 示例)、创建管理员账号等。
  4. 其他

    • 若遇 GitHub 下载失败,推荐使用如 gh-proxy.com 等代理加速服务。
    • Apache 和 PHP 模块通常在安装后自动启用,但必要时可通过 a2enmod 手动启用。
    • 初始安装成功后会显示自动生成的密码,建议立即登录后台修改。

标签: typecho, ubuntu, 部署

添加新评论