Skip to content

vps

日期：2024-01-27
存档：2023-05-01

如果你有一些，或者正在进行着记录、创作，无论是文字、图片还是音频、视频——像档案一样归类、保存它们，再使用流行却陌生的「生成式网页」工具，从你的文本文件和媒体文件生成Web页面，上传到云端，你便可以在空中有一块土地。你可以一砖一瓦地建造，亦或是重建。也可以在其中任意移动、偶尔清扫。对你来说，它是你的文件的备份，历史内容的归档，归属关系的证明。对于别人来说，它是高可信度的来源，目录化、图形化的可读、可视事物。

从「生成式网页」到「静态内容托管」，是很好的入门选择。例如从Hexo、Hugo等网页框架选择一或多个主题模板，通过Github Pages等服务，或者Vercel、Netlify等平台来构建和部署站点。

Hexo中更多的是博客模板，我最早使用了几年的Icarus，也较喜欢Stellar的风格。Hugo有相对丰富的主题，例如图墙模板的AutoPhugo、Gallery Deluxe、Hugo Split Gallery，食谱模板的recipe-book等等，也较容易修改源码。

而「部署到VPS」几乎是一门古代技术，此文即是这条古老却生僻的路线的徒步记录。主要途径「多个二级域名」、「开启HTTPS」，以及「本地Build」「云端Build」两种部署方案，涉及到了不少Unix系统上的基础操作。

而我之前买的VPS再不使用的话，就要到期了。最终，在那样一个原生环境下，低性能的VPS配置理应会有相对良好的性能。具体情况下，它又受到了VPS性能、网络运营商、CDN资源（Web字体等）、大型媒体文件（图片、音频、视频）等因素的影响。

选购VPS#

「旧笔记」

这里沿用了2021年的笔记，使用的是腾讯云VPS。随着平台后续的更新，具体的操作可能已经变化，但流程差不太多。选择其他云服务商也没什么问题。

  1. 注册腾讯云帐号 → 实名认证
  2. 购买云服务器
  3. 域名注册
  4. 域名 → 操作 → 解析 → 记录管理 → 添加记录 …
  5. 网站备案 → 我的备案 → 网站信息 → 新增网站 …
  6. 留意核验短信

备案时，需要让站点页面可以被访问。这个步骤可以放在最后。完成备案后会有年审（吧），每次年审会检查（主域名的）页面的底部是否有备案号链接，以及网站名称是否和提交的信息一致。

VPS上安装系统#

我最早使用「Ubuntu + Nginx」的组合，后来听说「CentOS + Apache」的性能会更好。Rocky Linux则是一个由社区支持的CentOS的代替品。

腾讯云 → 控制台 → 云服务器 → 实例 → 目标实例 → 操作系统 → 重装系统 → 重装配置:

镜像配置 公共镜像
目标镜像 Rocky Linux（我目前用的是9.3）
登录方式 设置密码
用户名 `root`
新密码 `YourPassword`
确认密码 `YourPassword`

登录VPS#

目标实例 → IP地址 YourHost (公) → 复制

我使用的SSH工具箱是WinSSHTerm。也可以选择WindTerm、electerm、MobaXterm等。

WinSSHTerm → Connections → Connect → Add Connection:

Name `vps`
Host/IP `YourHost`
port `22`
User `root`
Password `YourPassword`

双击vps → PuTTY Secutity Alert → Accept

更新系统软件包#

显示系统信息：

hostnamectl

更新所有软件包，确认时默认Yes：

dnf update -y

Apache上配置（多）站点#

安装Apache：

dnf install httpd php -y

在Rocky Linux的文档中，为了防止一个网站出问题时影响其他网站，网页的配置采用了稍复杂的文件结构。

mkdir -p /etc/httpd/sites-available /etc/httpd/sites-enabled

使用Vim编辑器编辑Apache的配置文件：

vi /etc/httpd/conf/httpd.conf

按PageDown定位到末尾。按i进入Insert模式，在新的一行，粘贴下面这行。在WinSSHTerm中可以右键粘贴：

IncludeOptional /etc/httpd/sites-enabled

按Esc退回Normal模式。按:进入Command模式，继续输入wq并回车，即write(save)并quit。

这里，文档将网站的配置文件新建在了sites-available/下，再通过系统链接，可选择地复制到sites-enabled/。文件夹中，以com.Example.www, com.Example.SubDomain（子域名）的风格来命名。且主域名的文件放在/var/www/html/，各个子域名的放在各自的/var/www/sub-domains/SubDomain/html/。

进行以下操作时，根据你的实际域名，替换掉Example.com, SubDomain等示例名。

新建并配置域名：

vi /etc/httpd/sites-available/com.Example

<VirtualHost *:80>
    ServerName www.Example.com
    ServerAlias Example.com
    DocumentRoot /var/www/html
    DirectoryIndex index.php index.htm index.html

    CustomLog "/var/log/httpd/access_log" combined
    ErrorLog  "/var/log/httpd/error_log"

    <Directory /var/www/html>
        Options -ExecCGI -Indexes
        AllowOverride None

        Order deny,allow
        Deny from all
        Allow from all

        Satisfy all
    </Directory>
</VirtualHost>

新建并配置二级域名：

vi /etc/httpd/sites-available/com.Example.SubDomain

<VirtualHost *:80>
    ServerName SubDomain.Example.com
    DocumentRoot /var/www/sub-domains/SubDomain/html
    DirectoryIndex index.php index.htm index.html

    CustomLog "/var/log/httpd/SubDomain-access_log" combined
    ErrorLog  "/var/log/httpd/SubDomain-error_log"

    <Directory /var/www/sub-domains/SubDomain/html>
        Options -ExecCGI -Indexes
        AllowOverride None

        Order deny,allow
        Deny from all
        Allow from all

        Satisfy all
    </Directory>
</VirtualHost>

新建文件夹：

mkdir -p /var/www/html

mkdir -p /var/www/sub-domains/SubDomain/html

启动Web服务：

systemctl start httpd
systemctl enable httpd

通过「新建或删除系统链接」，来开启或关闭站点。这里是开启：

ln -s /etc/httpd/sites-available/com.Example /etc/httpd/sites-enabled/
ln -s /etc/httpd/sites-available/com.Example.SubDomain /etc/httpd/sites-enabled/

每次编辑过站点配置，或者开关了站点后，重启Web服务：

systemctl restart httpd

去到腾讯云 → 控制台 → 云解析DNS → 我的解析 → 目标域名/解析 → 添加记录:

对于主域名，添加两条记录：

主机记录 `@`和`www`
记录类型 `A`
记录值 `YourHost`

对于子域名，新增记录：

主机记录 `SubDomain`
记录类型 `A`
记录值 `YourHost`

在浏览器中确认Example.com、SubDomain.Example.com。如果顺利，将看到：

↪ Apache web server multiple site setup
↪ What ServerAlias for my Subdomain?

防火墙设置#

在防火墙上，永久地打开公域的80和443端口，对应访问网站使用的HTTP和HTTPS协议。

firewall-cmd --permanent --zone=public --add-service=http
firewall-cmd --permanent --zone=public --add-service=https
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=443/tcp
firewall-cmd --reload
firewall-cmd --list-all

↪ How to install Apache on Rocky Linux 9
↪ firewalld for Beginners
↪ mod_ssl on Rocky Linux in an Apache web

配置SSL证书#

使用certbot来配置域名的SSL证书，启用HTTPS访问。安装软件包：

dnf install epel-release -y
dnf install certbot python3-certbot-apache mod_ssl -y
systemctl restart httpd

申请证书：

certbot --apache

回答3个问题：

  1. 填入一个你的邮箱来接收重要信息
  2. 阅读并接受用户协议的条款。我没有读，你可以读一读
  3. 是否愿意分享你的邮箱地址给它的一个合作伙伴、非盈利机构

如果顺利，这里会列出Web服务中开启的域名：

1: Example.com
2: www.Example.com
3: SubDomain.Example.com

输入数字，以空格间隔即可，如1 2 3。如果是以后新增一个域名，这里只需输入新域名的数字。

只是测试一下证书的续订功能是否正常：

certbot renew --dry-run

↪ Generating SSL keys - Let’s Encrypt

选择部署方式#

到此，如果你能够上传网页文件到对应的文件夹，就可以进行访问了。这个步骤，网络上有许多不同的方法和工具。例如，对于Hexo，可参考One-Command Deployment，对于Hugo，可参考Hosting and Deployment。我试过SiriKali、cwRsync等等，最终使用Gitbub Actions在云端进行构建，再部署到Gihub Pages和VPS。

本地Build#

这个方法源自Deploy Hexo sites to VPS。原文写于2015年，链接在几年前失效，我在Internet Archive上找到了存档并保存了副本。

安装和配置Git（PC上）#

在PC上，安装分布式版本控制系统Git。注册一个GitHub账号。打开终端，配置本机上的Git的用户信息：

git config --global user.name "YourName"
git config --global user.email YourEmail
git config --list

生成SSH密钥对，用来与远程Repo通信：

ssh-keygen -t rsa -C "YourEmail"

在浏览器中打开Github的SSH and GPG keys设置，选择「New SSH key」。复制C:\Users\YourName\.ssh\id_rsa.pub里的内容, 粘贴进去。密钥的名字随意，当你看到名字，能够知道是哪台设备即可。

测试与GitHub的SSH连接：

ssh -T git@github.com

这里的ssh.exe位于Git安装目录的\usr\bin\内，不是其他的ssh.exe。可以通过where ssh检查。

新建本地Repo（PC上）#

新建一个Repository，名称可以与你的网站有关。Repo默认「公开」，对所有人可见，这样也便能够使用Github Pages服务。

参考你的网页生成器的官方文档，新建项目文件夹，例如hexo init YourFolder, hugo new site YourFolder等命令。另外也需要阅读一遍你选择的主题模板的说明。

进入文件夹，新建一个本地Repo：

cd YourFolder
git init

添加远程Repo（PC上）#

首先，添加github.com上的远程Repo。这里的origin是随后的，目标远程Repo的默认的简称：

git remote add origin git@github.com:YourName/YourRepo.git

添加VPS上的远程Repo。这里，如果你使用Hexo和部署插件hexo-deployer-git，只需要编辑Hexo配置文件_config.yml，再添加一个Repo:

deploy:

  - type: git
    repo: git@github.com:YourName/Repo.git
    branch: main
  - type: git
    repo: SubUser@YourHost:/home/git/com.Example.git
    branch: main

这样，在运行hexo deploy后，会同时上传public/里的内容，分别到github.com和VPS上的Repo。

没有专用的部署工具时，可采用手动的方法，以Hugo为例。编辑.git/config，在origin下面，额外加一个URL：

[remote "origin"]
    url = https://github.com/YourName/Repo.git
    fetch = +refs/heads/*:refs/remotes/origin/*
    url = SubUser@YourHost:/home/git/com.Example.git
    fetch = +refs/heads/*:refs/remotes/vps/*

这个操作实际上是添加了一个VPS上的远程Repo：

git remote add vps SubUser@YourHost:/home/SubUser/com.Example.git

但是组合进了origin，使得运行git push -u origin main时，同时上传到两个Repo。

手动设置时，注意是否需要编辑.gitignore，来添加要忽略的文件和文件夹。

新建子用户#

回到VPS，新建上文提到的Repo。先添加一个SubUser（子用户），命名为git:

adduser git

设置子用户的登录密码：

passwd git

给予用户文件夹权限#

递归地给予git用户网页文件夹的权限：

chown git:git -R /var/www/html
chown git:git -R /var/www/sub-domains/SubDomain/html

为子用户开启SSH访问#

切换到git用户：

su git

为子用户设置用以SSH访问的密钥：

cd ~
mkdir .ssh
touch .ssh/authorized_keys
vim .ssh/authorized_keys

粘贴PC上的C:\Users\YourName\.ssh\id_rsa.pub里的内容，保存并退出。

回到PC，测试以git账户登录VPS：

ssh git@YourHost

文件夹里新建Hook脚本#

VPS上安装Git：

su root
yum install git -y

在子用户的home/目录里，新建仅用以协作的Repo：

su git
cd ~
mkdir com.Example.git
cd com.Example.git
git config --global init.defaultBranch main
git init --bare

com.Example.git对应了com.Example。com.Example.SubDomain.git则对应com.Example.SubDomain。

新建Hook脚本：

cd hooks
touch post-receive
chmod +x post-receive
vi post-receive

粘贴进去：

#!/bin/bash -l
GIT_REPO=/home/git/com.Example.git
TMP_GIT_CLONE=/tmp/com.Example
PUBLIC_WWW=/var/www/html
rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/BuildDir/* ${PUBLIC_WWW}

对应子域名是：

#!/bin/bash -l
GIT_REPO=/home/git/com.Example.SubDomain.git
TMP_GIT_CLONE=/tmp/com.Example.SubDomain
PUBLIC_WWW=/var/www/html/sub-domains/SubDomain/html
rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/BuildDir/* ${PUBLIC_WWW}

这是一个只有变量和命令的Bash文件，也只涉及了简单的命令。基本上，你需要留意2-4行的变量的值，以及最后一行。在最后一行，BuildDir是网页文件所在的目录，常见的目录名有public、site、docs等。如果你在PC上运行过构建命令，如hexo build、hugo build，将会看见。

如果使用了hexo-deployer-git，这行自然是：

cp -rf ${TMP_GIT_CLONE}/* ${PUBLIC_WWW}

从本地Repo上传（PC上）#

运行了构建命名，生成了网页文件后，暂存当前目录和子目录的所有更改：

git add .

描述一下这次更改，准备好提交：

git commit -m "SomeMessage"

第一次提交时，需指定远程仓库名和分支名，加上-u origin main：

git push -u origin main

打开浏览器，访问Example.com，查看页面是否更新。

云端Build#

首先去取得「部署到Github Pages」的自动化脚本。

以Hugo站点为例，参考Host on GitHub Pages，在.github/workflows下新建hugo.yaml，或者重命名为deploy.yml。填入内容并保存。

复制这个文件，重命名新文件为deploy_cps.yml，编辑该文件。修改这里的--baseURL这行:

run: |
  hugo \
    --minify \
    --baseURL "${{ steps.pages.outputs.base_url }}/"

到：

--baseURL "https://Example.com"

对应子域名是：

--baseURL "https://SubDomain.Example.com"

参考SCP for GitHub Actions，替换Deployment job以下的内容为：

- name: Rename public to html
  run: mv public html
- name: Copy file to server
  uses: appleboy/scp-action@v0.1.7
  with:
    host: ${{ secrets.VPS_HOST }}
    username: ${{ secrets.VPS_USERNAME }}
    password: ${{ secrets.VPS_PASSWORD }}
    port: ${{ secrets.VPS_PORT }}
    source: "./html/*"
    target: /var/www/

对应子域名是：

- name: Rename public to html
  run: mv public html
- name: Copy file to server
  uses: appleboy/scp-action@v0.1.7
  with:
    host: ${{ secrets.VPS_HOST }}
    username: ${{ secrets.VPS_USERNAME }}
    password: ${{ secrets.VPS_PASSWORD }}
    port: ${{ secrets.VPS_PORT }}
    source: "./html/*"
    target: /var/www/sub-domains/SubDomain/

去到你在Github上的Repo → Settings → Secrets and variables → Actions → New repository secret → 依次创建脚本中写到的4个secret。Name和Secret分别为：

VPS_HOST `YourHost`
VPS_PORT `22`
VPS_USERNAME `git`
VPS_PASSWORD `YourPassword`

再举一个例子，在Material for MkDocs的Publishing your site部分，也提供了脚本，并且提示去看MkDocs文档来进行手动部署。新建deploy.yml后，再复制一份，重命名为deploy_cps.yml，修改deploy_cps.yml的：

- run: mkdocs gh-deploy --force

到：

- run: mkdocs build --clean
- name: Rename site to html
  run: mv site html
- name: Copy file to server
  uses: appleboy/scp-action@v0.1.7
  with:
    host: ${{ secrets.VPS_HOST }}
    username: ${{ secrets.VPS_USERNAME }}
    password: ${{ secrets.VPS_PASSWORD }}
    port: ${{ secrets.VPS_PORT }}
    source: "./html/*"
    target: /var/www/

两个例子的最后，上传你的脚本并测试。直接在主分支上进行测试不是一个规范的操作，但问题不大：

git add .github\workflows\deploy.yml .github\workflows\deploy_scp.yml
git commit -m "test deploy_scp"
git push

到你在Github上的Repo的Actions栏，观察运行情况。如果顺利的话，将看到：

如果你未看到有任何信息，可能需要检查：

  • Setting → Pages → Build and deployment/Source → Github Actions …
  • Actions → I understand my workflows, go ahead and enable them

Bug

后来，我重新处理、压缩了BYYA上的所有图片。因为我不熟悉Git的某些操作，我删除并重新上传了整个Repo，也就遇到了Issue #169中说明的问题。

小抄#

最后，是一份小抄。如果你需要在VPS上，添加一个子域名，依次：

vi /etc/httpd/sites-available/com.Example.SubDomain

<VirtualHost *:80>
    ServerName SubDomain.Example.com
    DocumentRoot /var/www/sub-domains/SubDomain/html
    DirectoryIndex index.php index.htm index.html

    CustomLog "/var/log/httpd/demo-access_log" combined
    ErrorLog  "/var/log/httpd/demo-error_log"

    <Directory /var/www/sub-domains/SubDomain/html>
        Options -ExecCGI -Indexes
        AllowOverride None

        Order deny,allow
        Deny from all
        Allow from all

        Satisfy all
    </Directory>
</VirtualHost>

mkdir -p /var/www/sub-domains/SubDomain/html
ln -s /etc/httpd/sites-available/com.Example.SubDomain /etc/httpd/sites-enabled/
systemctl restart httpd

打开浏览器，登录VPS的控制台，添加子域名的解析。

certbot --apache

chown git:git -R /var/www/sub-domains/SubDomain/html
su git

cd ~
mkdir com.Example.SubDomain.git
cd com.Example.SubDomain.git
git config --global init.defaultBranch main
git init --bare
cd hooks
touch post-receive
chmod +x post-receive
vi post-receive

#!/bin/bash -l
GIT_REPO=/home/git/com.Example.SubDomain.git
TMP_GIT_CLONE=/tmp/com.Example.SubDomain
PUBLIC_WWW=/var/www/html/sub-domains/SubDomain/html
rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/BuildDir/* ${PUBLIC_WWW}

git add .
git commit -m "test add sub-domain"
git push