在VPS上安装Jekyll，从零开始的指南

Jekyll 是一款非常流行的静态网站生成器，它能够帮助你快速创建专业的个人博客或网站，如果你有VPS服务器，那么安装Jekyll并搭建个人网站是一个非常实用的技能，以下是一步一步的指南,帮助你顺利完成这个过程。

准备工作

在开始安装Jekyll之前，你需要确保你的VPS环境已经配置好了,以下是需要满足的条件：

1. 操作系统版本：Jekyll 支持 Ubuntu、CentOS、Fedora 等Linux版本,建议使用最新的版本以获得最佳兼容性。

2. 安装HTTP服务：确保你的VPS上有Nginx、Apache或其他静态文件服务器（Serving HTTP）服务，比如Nginx，Jekyll 会通过Nginx来发布静态文件。

3. 安装依赖项：Jekyll 需要一些必要的依赖项，如mocha和npm,这些工具帮助你构建和运行Jekyll项目。

安装Jekyll

通过源码安装Jekyll

Jekyll 的官方仓库托管在 GitHub 上,你可以通过以下命令从源码安装：

git clone https://github.com/jekyll/jekyll.git
cd jekyll
make

• git clone 下载Jekyll的源码仓库。
• cd jekyll 进入仓库目录。
• make 执行构建过程,这会生成静态网站的文件。

使用包管理器安装Jekyll

如果你不想从源码安装，也可以通过包管理器安装Jekyll,这通常适用于在线构建的项目。

sudo apt-get update && sudo apt-get install -y \
    curl \
    npm \
    node.js \
    jekyll

• curl 用于从远程源下载依赖项。
• npm 和 node.js 是Jekyll所需的脚本语言环境。
• jekyll 是安装和运行Jekyll的命令。

配置Jekyll

在安装完成后,Jekyll需要一些配置来适应你的需求。

创建jekyll.config

这是Jekyll的核心配置文件，用来设置输出格式、日志和缓存。

sudo nano /var/www/myvpsSite/.config/jekyll/jekyll.config

示例：

module jekyll
  output:
    site: /output
    pdf: /output/pdf
    book: /output/book
  cache: enabled
  cache deeper: true
  cache years: 5
  log:
    file: jekyll.log
    format: error: %H:%M:%S [ % (L local) (T global) ]
  html:
    variables:
      navbar: on
      sidebar: on
      comments: on
  plugins:
    jekyll-javascript: enabled
    jekyll-css: enabled
    jekyll-image优化: enabled
endmodule

设置基本选项

• 输出格式：默认是HTML，支持HTML、PDF、BOOK等格式。
• 缓存：启用缓存可以提高性能。
• 日志：记录日志有助于调试。
• HTML元数据、作者等信息。

搭建个人网站

创建目录结构

Jekyll需要一个静态资源目录来存储所有静态文件,通常的结构如下：

myvpsSite/
├── _/
│   ├── README.md
│   ├── _config.yml
│   └── jekyll.html
├── content/
│   ├── article1/
│   │   └── _/
│   │       ├── index.html
│   │       └── images/
│   │           └── cat.jpg
│   └── article2/
│       └── index.html
└── static/
    └── jekyll/
        ├── _/
        │   └── index.html
        └── js/
            └── _/
                └── index.html

• content目录存储文章。
• static目录存储静态资源（如图片、脚本）。
• _目录是Jekyll的元数据存储。

添加基本的HTML元数据

在content目录下,为每个文章设置元数据：

<article>
  <meta name="description" content="文章标题">
  <meta name="author" content="你的名字">
  <meta name="date" content="发布日期">
</article>

添加静态资源

将图片、CSS、JavaScript等文件放置在static目录下,并确保路径正确。

<img src="/static/images/cat.jpg" alt="我的猫">

部署和测试

部署到服务器

使用git push部署到服务器：

git push origin master

测试

使用浏览器访问：

xdg-open http://localhost:8080

（根据你的Nginx配置,可能需要调整端口）

优化和调试

图片压缩

Jekyll默认不会压缩图片，导致文件过大，可以使用jekyll img-opt命令优化图片：

sudo /usr/bin/npx node -p jekyll img-opt --format webp --recursive

查看日志

检查jekyll.log文件,了解构建过程中遇到的问题。

安全注意事项

防火墙设置

确保服务器的端口开放,允许Jekyll服务运行。

漏洞扫描

定期扫描服务器,修复已知漏洞。

备份数据

定期备份Jekyll项目和关键数据。

数据保护

考虑使用云存储服务备份服务器上的数据。

通过以上步骤，你已经成功在VPS上安装并配置了Jekyll，可以开始创建属于自己的静态网站了，Jekyll的强大功能和灵活性使其成为开发个人博客的理想选择,希望这篇文章能帮助你顺利完成搭建过程！