爱库录 目录即站点，文件即文章

从零开始：10分钟搭好你的第一个博客

2026-09-17 · 使用教程 · 返回列表

title: "从零开始：10 分钟搭好你的第一个博客" date: 2026-09-17 tags: [教程, 快速上手, 新手, 安装部署] category: 使用教程 description: "零基础教程。从下载到博客上线，10 分钟搞定。不需要任何前置知识。"

从零开始：10 分钟搭好你的第一个博客

这篇教程面向完全没用过爱库录的人。跟着做，10 分钟后你就有自己的博客了。

你需要什么

  • 一台服务器（1C1G 就够，轻量云 ¥30-50/月）
  • 一个域名（可选，没有也能先用 IP 访问）
  • SSH 连接到服务器的能力

不需要：Node.js、PHP、MySQL、Redis、Docker——什么都不要。

第 1 步：下载二进制（1 分钟）

SSH 进服务器，执行：

# 创建目录
mkdir -p /opt/aiklog && cd /opt/aiklog

# 下载（根据你的系统选择）
# Linux amd64（大多数服务器）
curl -LO https://aiklog.com/releases/latest/aiklog-linux-amd64

# Linux arm64（ARM 服务器）
# curl -LO https://aiklog.com/releases/latest/aiklog-linux-arm64

# 赋予执行权限
chmod +x aiklog-linux-amd64

验证一下：

./aiklog-linux-amd64 -version
# 输出版本号，说明下载成功

第 2 步：首次启动（2 分钟）

# 设置管理员密码（替换为你自己的密码）
export AIKMAP_ADMIN_PASSWORD="your-strong-password"

# 启动
./aiklog-linux-amd64 -addr 127.0.0.1:8780 -db ./data/aiklog.db

看到类似这样的输出，说明启动成功：

[INFO] AiKlog started on 127.0.0.1:8780
[INFO] Database: ./data/aiklog.db
[INFO] Blog directory: ./blog

保持这个终端运行。 后面我们会配置 systemd 来管理服务。

第 3 步：第一次访问（1 分钟）

浏览器打开：

http://你的服务器IP:8780/app#/blog?view=public

你会看到一个空白的博客页面。别急，我们还没有内容。

打开控制台：

http://你的服务器IP:8780/app#/desk

用刚才设置的管理员密码登录。

第 4 步：发布第一篇文章（2 分钟）

方法一：拖拽上传

  1. 在本地电脑上创建一个 Markdown 文件：
---
title: "我的第一篇博客"
date: 2026-09-17
tags: [测试]
description: "这是我的第一篇博客文章。"
---

# 我的第一篇博客

Hello World! 这是我用爱库录搭建的博客。

## 为什么要写博客

把想法写下来，是为了确认自己真的想清楚了。

## 下一步

打算写一些技术笔记和读书摘要。
  1. 打开控制台 → 博客管理
  2. 把文件拖进去
  3. 刷新前台页面，文章已经出现了

方法二：直接放文件

SSH 进服务器：

cat > /opt/aiklog/blog/我的第一篇博客.md << 'EOF'
---
title: "我的第一篇博客"
date: 2026-09-17
tags: [测试]
---

# 我的第一篇博客

Hello World!
EOF

刷新前台页面，文章出现了。

第 5 步：配置域名和 HTTPS（3 分钟）

如果你有域名，这一步让博客通过 HTTPS 访问。

安装 Caddy

# Ubuntu/Debian
apt install -y caddy

# CentOS/RHEL
yum install -y caddy

配置反代

cat > /etc/caddy/Caddyfile << 'EOF'
你的域名.com {
    reverse_proxy localhost:8780
}
EOF

启动 Caddy

systemctl enable caddy
systemctl start caddy

Caddy 自动申请 Let's Encrypt 证书，自动续期。 你不需要手动配置 HTTPS。

现在访问 https://你的域名.com，博客已经通过 HTTPS 上线了。

第 6 步：配置 systemd（1 分钟）

让爱库录开机自启、崩溃自动重启：

cat > /etc/systemd/system/aiklog.service << 'EOF'
[Unit]
Description=AiKlog Blog
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/aiklog
Environment=AIKMAP_ADMIN_PASSWORD=your-strong-password
ExecStart=/opt/aiklog/aiklog-linux-amd64 -addr 127.0.0.1:8780 -db /opt/aiklog/data/aiklog.db
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable aiklog
systemctl start aiklog

验证：

systemctl status aiklog
# Active: active (running)

完成

你的博客已经上线了：

  • 前台：https://你的域名.com
  • 控制台：https://你的域名.com/app#/desk
  • RSS：https://你的域名.com/api/v1/blog/feed.xml

从下载到上线，6 步，10 分钟。

下一步

  • 多写几篇文章放进博客目录
  • 试试语义搜索功能
  • 挑一个喜欢的主题
  • 读读 [[用文件管理器管理博客]] 了解日常管理

这是「使用教程」系列的第一篇。进阶内容见 [[Obsidian + 爱库录：笔记变博客的完整工作流]]。