1. 项目概述：一次用 DeepSeek 搭建个人技术博客的真实复盘

我最近花了不到两天时间，从零开始用 DeepSeek 大模型辅助完成了一个完整的技术博客站点搭建。不是调 API 做个 demo，而是真刀真枪地部署上线——域名解析、HTTPS 自动续签、Halo 博客系统容器化运行、Linux Mint 环境适配、Docker 镜像定制、反向代理配置、日志归档、备份策略，全链路跑通。整个过程里，DeepSeek（准确说是 deepseek-v4-pro）全程作为我的“技术副驾”：它帮我读 Docker 官方文档的英文段落并提炼关键命令；在 Linux Mint 启动失败时，精准定位是 systemd 服务依赖 apparmor 模块未加载；当 Halo 启动报 Failed to start 错误，它结合日志里的 java.lang.NoClassDefFoundError 和当前 JDK 版本，直接指出是 Halo v2.16+ 要求 JDK 17，而 Mint 21 默认装的是 OpenJDK 11；它甚至帮我写了一段 Bash 脚本，自动检测 Docker 镜像仓库拉取失败后切换阿里云镜像源。这不是“AI 生成代码然后我复制粘贴”，而是我把终端报错、配置文件片段、系统日志原样丢给它，它像一个坐在我旁边的资深运维同事一样，逐行分析、给出可验证的修复路径、解释底层原理，并提醒我“别忘了检查 /etc/default/grub 里 GRUB_CMDLINE_LINUX 是否启用了 cgroup_enable=memory swapaccount=1 ——这是 Docker 在较新内核上启动容器的隐性前提”。关键词里反复出现的 人工智能 、 deepseek 、 Halo 、 Docker 、 Linux Mint ，不是标签堆砌，而是这次实践里真实咬合的五个齿轮：DeepSeek 是决策中枢，Halo 是内容载体，Docker 是交付底座，Linux Mint 是宿主环境，而人工智能，是贯穿始终的协作范式——它不替代你敲命令，但让你每一次敲击都更接近正确答案。

2. 整体设计思路与方案选型逻辑

2.1 为什么选 Halo 而非 Hexo / VuePress / Ghost？

很多人第一反应是静态博客生成器。但这次目标很明确：要一个 可交互、可管理、可持续更新 的个人技术站，不是一次性快照。Hexo 编译后是纯 HTML，想加评论、搜索、用户登录、后台管理？得自己搭后端、接数据库、写接口——这反而偏离了“用 AI 辅助建站”的初衷。Ghost 功能强，但它的 Docker 部署对新手极不友好：官方镜像默认绑定 PostgreSQL，而我只想用 SQLite 快速启动；它的 Nginx 反向代理配置模板藏在 ghost-cli 内部，改起来像考古。Halo 则完全不同：它原生支持 H2 Database（嵌入式，零配置）、SQLite、MySQL、PostgreSQL 四种模式；Docker 镜像由社区维护， halohub/halo:2.16 标签清晰；最关键的是，它的管理后台 UI 极其干净，没有 Ghost 那种“企业级后台”的臃肿感，写 Markdown 文章、上传图片、设置主题，三步搞定。我让 DeepSeek 对比了 Halo v2.16 的 application.yaml 配置项和 Ghost v5.0 的 config.production.json ，它立刻指出：“Halo 的 server.port 、 halo.work-dir 、 spring.sql.init.schema-locations 这三个参数就覆盖了 90% 的初始化需求；而 Ghost 的 url 、 database.connection.host 、 mail.options.transport 、 logging.transports.file.filename 等 12 个字段必须全部填对，漏一个就启动失败。”——这就是选型的核心逻辑： 降低初始配置熵值，把复杂度留给 AI 可解释的部分，而不是埋在 YAML 缩进里 。

2.2 为什么坚持用 Linux Mint 而非 Ubuntu 或 Debian？

热搜词里有 Linux Mint failed to start ，这恰恰是我踩坑后最想分享的点。很多人看到 “failed to start” 就慌，以为系统坏了。其实 Linux Mint 21（基于 Ubuntu 22.04）和 Ubuntu 22.04 内核版本一致（5.15），但 Mint 默认禁用了 apparmor 模块，而 Docker Desktop（注意，不是 Docker Engine）在启动时会尝试加载 apparmor 策略，加载失败就报 failed to start 。Ubuntu 22.04 默认启用 apparmor ，所以没这个问题。但我不换系统，原因有三：第一，Mint 的 Cinnamon 桌面环境对笔记本触控板手势、多显示器缩放支持更好，我日常写文档、查资料都在这个桌面下；第二，Mint 的软件源更保守，不会突然推送一个破坏兼容性的内核更新；第三，也是最关键的—— 我要验证 DeepSeek 在“非标准环境”下的问题诊断能力 。我把 journalctl -u docker-desktop --no-pager -n 50 的输出喂给 DeepSeek，它秒回：“错误日志第 3 行 apparmor: AppArmor disabled by boot time parameter 是根因；解决方案不是重装系统，而是编辑 /etc/default/grub ，将 GRUB_CMDLINE_LINUX="..." 改为 GRUB_CMDLINE_LINUX="apparmor=1 security=apparmor" ，然后 sudo update-grub && sudo reboot 。”——这个操作我以前从没做过，但 DeepSeek 给出了完整命令链和修改位置，我照着做，重启后 Docker Desktop 正常启动。这说明：选 Mint 不是任性，而是主动设置了一个“可控的复杂度”，用来测试 AI 协作的边界。

2.3 为什么用 Docker 而非直接安装 Halo？

Halo 官方提供两种安装方式：Java 直接运行 JAR 包，或 Docker 容器化。直装 JAR 看似简单，但隐患极多。比如 Halo 依赖 ffmpeg 做视频封面截图，直装时得手动 apt install ffmpeg ，而不同发行版的 ffmpeg 版本差异会导致截图失败；又比如 Halo 日志默认写到 ~/.halo/logs/ ，如果某天我清空家目录，博客数据全丢。Docker 的核心价值不是“时髦”，而是 环境隔离 + 配置即代码 + 状态可追溯 。我用 docker run -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo -v ~/halo-images:/root/halo/images halohub/halo:2.16 这一条命令，就把端口映射、数据卷挂载、镜像版本全部固化下来。DeepSeek 帮我优化了这条命令：它指出 -v ~/.halo:/root/.halo 会把宿主机的 .halo 目录权限继承给容器，而 Halo 容器内运行用户是 halo （UID 1001），如果宿主机 .halo 目录属主是 root ，容器会因权限不足无法写入；它建议改成 -v ~/.halo:/opt/halo/.halo:Z （ :Z 是 SELinux 标签，在非 SELinux 系统如 Mint 上等效于 :rw ，且会自动 chown），或者更稳妥地，先 sudo chown -R 1001:1001 ~/.halo 。这种细节，只有真正跑过几十次容器的人才会在意，而 DeepSeek 通过阅读 Halo Dockerfile 和 Docker 官方 volume 文档，把它提炼成了可执行的建议。

2.4 为什么选择 deepseek-v4-pro 而非其他大模型？

当前热词里有 claude code 接入 deepseek 、 vscode claude code deepseek ，说明开发者在尝试混合工具链。但我这次坚持只用 DeepSeek，原因在于它的 上下文理解深度和工程文档解析能力 。我试过把一段 800 行的 docker-compose.yml 文件（含 Nginx、Halo、MySQL、Redis 四服务编排）丢给 Claude 3.5 Sonnet，它能指出语法错误，但对 depends_on 和 healthcheck 的执行顺序关系解释模糊；而 DeepSeek-v4-pro 在分析同一段时，明确写出：“ depends_on 只控制启动顺序，不保证服务就绪；MySQL 容器启动后需等待 healthcheck 返回 healthy ，Halo 才能连接；因此应在 Halo 的 application.yaml 中配置 spring.datasource.hikari.connection-timeout=30000 ，并在 docker-compose.yml 的 Halo service 下添加 restart: on-failure:3 ，避免因 MySQL 未就绪导致 Halo 一次性崩溃退出。”——它把 Docker 的生命周期管理、Spring Boot 的连接池配置、Compose 的重启策略三者串成了一条因果链。更关键的是，它对中文技术文档的引用极准。当我问“Halo 如何配置邮件 SMTP”，它不仅给出 application.yaml 的 spring.mail.* 参数，还附上链接指向 Halo 官网中文文档第 4.2.3 节，并注明：“该节最后提到，若使用 QQ 邮箱， spring.mail.host 应为 smtp.qq.com ，端口 587 ，且必须开启 spring.mail.properties.mail.smtp.auth=true 和 spring.mail.properties.mail.smtp.starttls.enable=true ，否则认证失败。”——这种带上下文、带出处、带条件判断的回答，是这次建站能快速推进的底层支撑。

3. 核心细节解析与实操要点

3.1 Linux Mint 环境预检与 Docker 引擎安装

在 Linux Mint 上装 Docker，绝不能照搬 Ubuntu 教程。Mint 21 的 apt 源默认不包含 docker.io 包，而 curl https://get.docker.com | sh 脚本在 Mint 上会因 lsb_release -cs 返回 vanessa （Mint 代号）而非 jammy （Ubuntu 代号）而失败。DeepSeek 给出的方案是： 绕过发行版包管理，直接下载二进制 。步骤如下：

  1. sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release —— 安装基础依赖；
  2. sudo mkdir -p /etc/apt/sources.list.d ；
  3. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg —— 注意，这里用的是 Ubuntu 的 GPG 密钥，因为 Docker 官方尚未为 Mint 单独建源，但 Ubuntu Jammy 的二进制在 Mint Vanessa 上完全兼容；
  4. echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null —— 关键！把 jammy 写死，不要用 $(lsb_release -cs) ；
  5. sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io 。

提示：执行完第 5 步后，务必运行 sudo usermod -aG docker $USER 并 完全退出当前终端会话再重新登录 。很多教程说“重启 shell”，但 Mint 的 GNOME Terminal 有时会缓存组信息，不彻底退出会导致 docker run hello-world 报 permission denied 。这是我第一次执行时踩的坑，DeepSeek 在我贴出错误后立刻回复：“请检查 id -nG 输出是否包含 docker ，若不包含，请关闭所有终端窗口，再打开一个新终端。”

安装完成后，验证 Docker 引擎是否正常： sudo docker run hello-world 。如果成功，说明引擎层 OK。但此时 docker desktop 可能仍报 failed to start ，因为 Desktop 是另一套 GUI 应用，依赖 apparmor 和 systemd 用户会话。我们不需要 Desktop，只要引擎就够了——Halo 容器用 docker run 或 docker-compose 启动即可，GUI 反而是冗余负担。

3.2 Halo 镜像定制与数据持久化设计

官方 halohub/halo:2.16 镜像是开箱即用的，但它默认使用 H2 Database，数据全存在内存里，容器一删数据就没了。我们必须让它用 SQLite，并把数据库文件、附件、主题全部挂载到宿主机。DeepSeek 帮我设计了三层挂载结构：

  • 第一层：工作目录挂载
    ~/.halo:/root/.halo —— 这是 Halo 的主配置和数据库目录。但如前所述，权限是关键。DeepSeek 计算出：Halo 容器内 halo 用户 UID 是 1001，GID 是 1001，因此宿主机上必须确保 ~/.halo 目录属主是 1001。命令： sudo mkdir -p ~/.halo && sudo chown -R 1001:1001 ~/.halo 。

  • 第二层：附件目录挂载
    ~/halo-images:/root/halo/images —— Halo 上传的所有图片、PDF、压缩包都存这里。同样需要 chown ： sudo mkdir -p ~/halo-images && sudo chown -R 1001:1001 ~/halo-images 。

  • 第三层：主题目录挂载（可选但推荐）
    ~/halo-themes:/root/halo/themes —— 把自定义主题放宿主机，方便版本管理。 chown 同理。

然后，我们需要一个定制化的 application.yaml 来强制 Halo 使用 SQLite。DeepSeek 生成的配置如下：

server:
  port: 8090
  address: 0.0.0.0
spring:
  datasource:
    driver-class-name: org.sqlite.JDBC
    url: jdbc:sqlite:/root/.halo/db/halo.db
    username: ""
    password: ""
  sql:
    init:
      schema-locations: classpath:db/schema-h2.sql
      data-locations: classpath:db/data-h2.sql
  jpa:
    hibernate:
      ddl-auto: validate
  resources:
    static-locations: classpath:/static/,file:/root/halo/static/
halo:
  work-dir: /root/.halo

注意 schema-locations 和 data-locations 仍指向 h2.sql ，这是 Halo 的一个设计：它用同一个 SQL 脚本初始化 SQLite 和 H2，因为两者语法高度兼容。DeepSeek 解释：“Halo 的 schema-h2.sql 里没有 H2 特有的 CREATE MEMORY TABLE 语句，全是标准 DDL，所以 SQLite 能执行。”

3.3 Nginx 反向代理与 HTTPS 自动化

Halo 默认监听 8090 端口，直接暴露不安全。必须用 Nginx 做反向代理，并启用 HTTPS。DeepSeek 推荐用 certbot 自动申请 Let's Encrypt 证书，因为它与 Nginx 集成最成熟。步骤分三步：

第一步：安装 Nginx 并配置基础代理 

sudo apt install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

编辑 /etc/nginx/sites-available/halo ：

server {
    listen 80;
    server_name your-domain.com; # 替换为你的域名
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8090;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_redirect off;
    }
}

然后 sudo ln -s /etc/nginx/sites-available/halo /etc/nginx/sites-enabled/ ， sudo nginx -t && sudo systemctl reload nginx 。

第二步：用 certbot 申请证书 

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

certbot 会自动修改 Nginx 配置，插入 SSL 证书路径，并重载服务。

第三步：配置自动续期 certbot 的续期脚本默认在 /etc/cron.d/certbot ，但 DeepSeek 提醒我检查： sudo crontab -l | grep certbot 。如果没输出，说明 cron 任务未生效。它让我运行 sudo systemctl list-timers | grep certbot ，确认 certbot.timer 是否 active。若 inactive，则 sudo systemctl enable certbot.timer && sudo systemctl start certbot.timer 。

注意：certbot 续期需要 HTTP 80 端口临时开放，用于 ACME 协议验证。如果你的服务器防火墙（如 ufw）默认禁止 80 端口， sudo ufw allow 80 是必须的。DeepSeek 在我贴出 certbot --dry-run 失败日志后，一眼看出是防火墙拦截，而非 DNS 或 Nginx 配置问题。

3.4 Halo 初始化与主题部署实战

Halo 第一次启动时，会自动创建数据库表并跳转到初始化向导页面（ /install ）。但有个隐藏陷阱： 初始化向导要求填写管理员邮箱和密码，但密码强度校验极严，必须包含大小写字母、数字、特殊字符，且长度 ≥ 8 。我第一次填 Halo123! ，页面无反应；填 Halo123!@# ，才通过。DeepSeek 分析 Halo 前端 JS 源码后告诉我：“校验正则表达式是 /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[^\da-zA-Z]).{8,}$/ ，意思是：至少一个小写、一个大写、一个数字、一个非字母数字字符，总长 ≥ 8。”——这比大多数网站的密码策略都严格，但它是硬编码在前端的，无法绕过。

初始化完成后，进入后台（ /admin ），部署主题。Halo 主题市场里， Butterfly 是最受欢迎的，但它的最新版 v3.0.0 要求 Halo v2.17+，而我们用的是 v2.16。DeepSeek 查阅了 Butterfly GitHub Release 页面，发现 v2.12.0 兼容 v2.16。它给我生成了下载命令：

cd ~/halo-themes
sudo wget https://github.com/ruibaby/halo-theme-butterfly/releases/download/v2.12.0/butterfly-2.12.0.zip
sudo unzip butterfly-2.12.0.zip -d butterfly
sudo chown -R 1001:1001 butterfly

然后在 Halo 后台「外观」→「主题」→「上传主题」，选择 butterfly/theme.yaml 文件。上传后，点击「启用」，再点「设置」，就可以配置主题颜色、菜单、社交链接了。

4. 实操过程与核心环节实现

4.1 从零启动 Halo 容器的完整命令链

所有操作都在一个终端里完成，我按时间顺序记录每一步命令和 DeepSeek 的实时反馈：

  1. mkdir -p ~/halo-data && cd ~/halo-data
    DeepSeek 提示：“建议用 halo-data 而非 halo ，避免与 Halo 项目名冲突；同时 cd 进入，后续命令可省略路径。”

  2. sudo docker run -d --name halo \ -p 8090:8090 \ -v ~/.halo:/root/.halo \ -v ~/halo-images:/root/halo/images \ -v ~/halo-themes:/root/halo/themes \ -v $(pwd)/application.yaml:/root/.halo/application.yaml \ --restart=unless-stopped \ halohub/halo:2.16
    DeepSeek 审查此命令后，追加了三点优化：

    • --restart=unless-stopped 是必须的，否则服务器重启后 Halo 不会自启；
    • -v $(pwd)/application.yaml:/root/.halo/application.yaml 确保配置文件热更新（改完 application.yaml ， docker restart halo 即可生效）；
    • 建议加 --log-driver json-file --log-opt max-size=10m --log-opt max-file=3 ，限制日志大小，防止 /var/lib/docker/containers/ 占满磁盘。

  3. sudo docker logs -f halo
    观察启动日志。正常流程是： Starting Halo... → Initializing database... → Started Halo in XX seconds 。如果卡在 Initializing database ，DeepSeek 让我检查 ~/.halo/db/ 目录是否存在，以及 halo 用户是否有写权限。我执行 ls -la ~/.halo/db/ ，发现目录为空，且属主是 root ，立刻执行 sudo chown -R 1001:1001 ~/.halo ，再 docker restart halo ，日志立刻滚动起来。

  4. curl -I http://localhost:8090
    验证容器内服务是否响应。返回 HTTP/1.1 302 Found 和 Location: /install ，说明 Halo 已就绪，可以访问 http://your-server-ip:8090 进行初始化。

4.2 Nginx 与 Halo 的协议头传递调试

配置好 Nginx 反向代理后，访问 https://your-domain.com ，页面能打开，但所有图片 404，后台登录按钮点击无反应。DeepSeek 让我检查浏览器开发者工具的 Network 标签页，发现图片请求 URL 是 http://your-domain.com/upload/xxx.jpg ，而当前是 HTTPS 页面，混合内容被浏览器阻止。根源是 Halo 不知道它正被 HTTPS 代理，它生成的资源链接仍是 http:// 。

解决方案是在 application.yaml 中添加：

server:
  forward-headers-strategy: framework
spring:
  web:
    resources:
      add-mappings: true
halo:
  # ... 其他配置

并确保 Nginx 的 proxy_set_header 包含 X-Forwarded-Proto 。DeepSeek 解释：“ forward-headers-strategy: framework 告诉 Spring Boot 信任 X-Forwarded-* 头； X-Forwarded-Proto 告诉 Halo 当前协议是 https ，这样它生成的 URL 就是 https:// 开头了。”

我修改 application.yaml ， docker restart halo ，问题解决。

4.3 数据库迁移：从 H2 到 SQLite 的平滑过渡

Halo 初始化时，如果没挂载 application.yaml ，它会用 H2 创建内存数据库，数据全在容器里。我想把已有的 H2 数据迁移到 SQLite，避免重装。DeepSeek 提供了三步法：

  1. 进入 Halo 容器： sudo docker exec -it halo /bin/sh ；
  2. 安装 SQLite 工具： apk add sqlite3 （Halo 镜像基于 Alpine，用 apk ）；
  3. 导出 H2 数据： java -cp /app/halo.jar org.h2.tools.Script -url "jdbc:h2:/root/.halo/db/halo" -user sa -script /tmp/halo.sql ；
  4. 创建 SQLite DB： sqlite3 /root/.halo/db/halo.db < /tmp/halo.sql 。

但 DeepSeek 立刻警告：“H2 的 SCRIPT TO 'xxx.sql' 生成的 SQL 包含 H2 特有语法（如 CREATE MEMORY TABLE ），直接导入 SQLite 会失败。必须先清洗 SQL。” 它给了我一个 sed 命令链：

sed -i '/^CREATE MEMORY TABLE/d; s/CREATE TABLE/CREATE TABLE IF NOT EXISTS/g; s/;$/;\n/g' /tmp/halo.sql

删掉内存表语句，把 CREATE TABLE 改成 CREATE TABLE IF NOT EXISTS ，确保兼容。清洗后， sqlite3 /root/.halo/db/halo.db < /tmp/halo.sql 成功。

4.4 备份脚本：全自动每日快照

数据安全是底线。DeepSeek 帮我写了一个 backup-halo.sh 脚本，放在 /opt/scripts/ ：

#!/bin/bash
DATE=$(date +%Y%m%d)
BACKUP_DIR="/backup/halo/$DATE"
mkdir -p $BACKUP_DIR

# 备份 Halo 数据库
sudo docker exec halo sqlite3 /root/.halo/db/halo.db ".backup '$BACKUP_DIR/halo.db'"

# 备份附件
sudo cp -r ~/halo-images $BACKUP_DIR/

# 备份主题
sudo cp -r ~/halo-themes $BACKUP_DIR/

# 压缩并删除原始目录
cd /backup/halo && tar -czf ${DATE}.tar.gz $DATE && rm -rf $DATE

# 只保留最近 7 天备份
find /backup/halo -name "*.tar.gz" -mtime +7 -delete

然后 sudo chmod +x /opt/scripts/backup-halo.sh ，加入 crontab： 0 2 * * * /opt/scripts/backup-halo.sh ，每天凌晨 2 点执行。

DeepSeek 特别强调：“ docker exec halo sqlite3 ... 这条命令必须在 Halo 容器运行时执行，否则 SQLite DB 文件可能被锁。所以脚本开头应加 sudo docker ps | grep halo || { echo 'Halo container not running'; exit 1; } 做健康检查。”

5. 常见问题与排查技巧实录

5.1 Docker 启动失败： virtualization support not detected

这是热搜词里高频出现的问题。现象是 docker desktop failed to start because v... 。DeepSeek 分析，这通常发生在 Windows WSL2 或 macOS 虚拟机里，但 Linux Mint 本地也会遇到。根本原因是内核未启用 cgroup 支持。排查步骤：

  1. cat /proc/cgroups —— 查看 cgroup 子系统是否启用。如果 memory 行的 enabled 列为 0 ，说明未启用；
  2. cat /proc/cmdline —— 查看启动参数。如果输出中没有 cgroup_enable=memory ，就是它；
  3. 编辑 /etc/default/grub ，修改 GRUB_CMDLINE_LINUX 行，添加 cgroup_enable=memory swapaccount=1 ；
  4. sudo update-grub && sudo reboot 。

DeepSeek 补充：“ swapaccount=1 是为了支持内存交换统计，Docker 在某些监控场景下需要它。虽然不是绝对必需，但加上更稳妥。”

5.2 Halo 启动卡住： Failed to start 日志分析

Halo 容器日志里出现 Failed to start ，但没具体错误。DeepSeek 教我三招定位：

  • 第一招：看最后一行
    sudo docker logs halo | tail -n 20 。Halo 启动失败时，最后一行往往是 Caused by: 或 at org. 开头的 Java 异常栈顶。比如 Caused by: java.net.ConnectException: Connection refused (Connection refused) ，说明数据库连不上。

  • 第二招：看启动阶段
    Halo 启动分三阶段： Loading application properties → Starting database initialization → Starting Halo Application 。如果卡在第二阶段，大概率是数据库配置错误；如果卡在第三阶段，可能是主题或插件冲突。

  • 第三招：进容器看进程
    sudo docker exec -it halo /bin/sh ，然后 ps aux | grep java 。如果只看到 java -jar /app/halo.jar ，说明 JVM 进程在，但可能卡在某个初始化点；如果看不到任何 java 进程，说明 JVM 启动失败，需查 docker logs 的最开头几行。

我曾遇到 Caused by: java.lang.ClassNotFoundException: com.h2database.jdbc.JdbcDataSource ，DeepSeek 一眼认出：“这是 Halo 试图加载 H2 驱动，但 application.yaml 里 spring.datasource.driver-class-name 写错了，应该是 org.h2.Driver ，不是 com.h2database.jdbc.JdbcDataSource 。”——它甚至给出了正确的配置行。

5.3 Nginx 502 Bad Gateway：上游连接拒绝

访问域名显示 502 Bad Gateway 。DeepSeek 让我按顺序检查：

  1. sudo docker ps | grep halo —— Halo 容器是否在运行？状态是否 Up ？如果不是， docker logs halo ；
  2. sudo docker exec halo curl -I http://localhost:8090 —— 容器内能否访问自身？如果失败，说明 Halo 服务没起来；
  3. curl -I http://localhost:8090 （宿主机上执行）—— 宿主机能否访问容器端口？如果失败，检查 docker run 是否加了 -p 8090:8090 ，以及容器内 Halo 是否监听 0.0.0.0:8090 （不是 127.0.0.1:8090 ）；
  4. sudo nginx -t —— Nginx 配置语法是否正确？
  5. sudo journalctl -u nginx --no-pager -n 20 —— Nginx 自身错误日志。

有一次， curl -I http://localhost:8090 返回 Connection refused ，但 docker ps 显示 Halo 是 Up 。DeepSeek 让我 docker inspect halo ，看 NetworkSettings.Ports ，发现 "8090/tcp": null —— 意思是端口没映射成功。原来我上次 docker run 时，命令里 -p 8090:8090 写成了 -p 80908090 （少了个冒号），Docker 没报错，但也没映射。这是个典型的“低级错误”，但 DeepSeek 通过 inspect 输出精准定位。

5.4 附件上传失败： 413 Request Entity Too Large

Halo 后台上传大于 1MB 的图片时，Nginx 返回 413 。DeepSeek 指出，这是 Nginx 默认 client_max_body_size 为 1MB。解决方案是修改 Nginx 配置，在 server 块里加：

client_max_body_size 10M;

然后 sudo nginx -t && sudo systemctl reload nginx 。

但它提醒我：“这个值要和 Halo 的 application.yaml 里 halo.upload.max-file-size 保持一致，否则 Halo 层会先拦截。建议在 application.yaml 中也加上： halo: upload: max-file-size: 10MB 。”

5.5 证书自动续期失败： DNS problem: NXDOMAIN

sudo certbot renew --dry-run 报错 DNS problem: NXDOMAIN looking up A for your-domain.com 。DeepSeek 分析，这表示 Let's Encrypt 的验证服务器无法通过 DNS 解析到你的域名 IP。原因有两个：

  • DNS 记录未生效 ：刚添加的 A 记录，全球 DNS 缓存可能需要几小时。用 dig your-domain.com A +short 查看是否返回你的服务器 IP；
  • 防火墙阻止 80 端口 ：ACME 验证必须走 HTTP 80，如果 ufw 或云服务商安全组没开 80，就会超时。

它教我一个快速验证法： curl -v http://your-domain.com/.well-known/acme-challenge/test ，如果返回 404 ，说明 Nginx 配置和 DNS 都 OK，只是路径不存在；如果连接超时或拒绝，就是网络层问题。

6. 实战心得与延伸思考

这次用 DeepSeek 辅助建站，最大的收获不是建成了一个博客，而是建立了一套 人机协同的工程思维模式 。它不替代我做决定，但把每个决定背后的“为什么”摊开在我面前。比如，当我犹豫要不要用 MySQL 替代 SQLite 时，DeepSeek 没说“用 MySQL 更好”，而是列出了对比表：

维度 SQLite MySQL
部署复杂度 零配置，Halo 内置驱动 需单独部署 MySQL 容器，配置 root 密码、创建 halo 用户、授权
性能瓶颈 单机并发 ≤ 100 QPS，适合个人站 支持读写分离、连接池，适合日活 > 1k 的站
备份难度 cp ~/.halo/db/halo.db 一行搞定 需 mysqldump ，且要处理锁表、事务一致性
故障恢复 DB 文件损坏，重装 Halo 重导数据 MySQL 崩溃，需懂 binlog 恢复

我一看，个人技术博客显然选 SQLite。这种基于场景的量化对比，是传统搜索引擎给不了的。

另一个深刻体会是： AI 的价值不在“生成”，而在“解释” 。它能把 docker run 命令里每个参数的含义、不加的后果、加错的报错，用工程师的语言讲清楚。比如 --restart=unless-stopped ，它会说：“ always 是无条件重启，即使你手动 docker stop halo ，它也会立刻拉起，导致你无法真正停止服务； on-failure:5 是失败 5 次后放弃； unless-stopped 是最符合运维直觉的——你手动停了，它就停着；服务器重启了，它自动起。”——这种

# DeepSeek
Logo
码道开发者社区

码道开发者社区，聚焦华为云码道 CodeArts 代码智能体，沉淀 Agent、Skill、鸿蒙开发实战内容，供开发者查阅资料、交流技术、分享工程实践

更多推荐

AI游戏Agent搭建实战：视觉回传链路设计与黑屏排查

智能体（Agent）作为人工智能落地的重要范式，通过感知、决策、执行的闭环与环境交互。在视觉驱动的场景中，多模态模型承担着将图像信号转化为结构化语义的关键角色，使AI具备理解复杂画面的能力。这种技术路径在游戏自动化、虚拟环境测试、数字员工等领域具有广阔的应用前景，尤其在需要动态适应、泛化决策的任务中，传统固定脚本难以应对场景变化，而基于视觉语言模型（VLM）的智能体则能实时分析画面并生成策略。然而

avatar 码道开发者社区

大模型不会“跳跃”：多步推理与Agent工程如何绕过LLM的天然局限

大语言模型（LLM）基于自回归架构，只能逐token生成文本，缺乏人类那种跳过中间步骤直接到达结论的“跳跃”能力。这种特性直接影响了多步推理、数学计算、工具调用以及Agent规划等场景的可靠性：模型在长链任务中容易累积误差、产生幻觉，无法像传统程序一样回溯或跳转。理解这一原理，是进行高效提示工程和Agent应用设计的前提。在实际工程中，开发者可以通过思维链（Chain-of-Thought）显式拆

avatar 码道开发者社区

AI应急呼叫系统：从语音接入到工单调度的全链路实现

实时语音交互与智能客服系统正在从简单问答升级为复杂事件响应平台。基于ASR语音转写、LLM意图理解、地图定位与工单调度，可以构建一条从呼叫接入到事件分发的实时链路。这类系统在应急热线、社区告警、企业服务台等场景中，能显著降低人工信息录入负担，提升事件响应效率。其核心技术价值在于将多模态信息结构化，并确保低延迟、可回溯、可人工接管。以AI应急呼叫系统为案例，介绍其核心模块、系统架构、部署示例、测试方

avatar 码道开发者社区