使用 Vanblog 也有好长一段时间了，还挺喜欢这个博客的。但是目前作者的更新不活跃，使用过程中又会遇到一些问题，只能摸索一些解决文案，并记录在这里以备不时之需。

VanBlog 官方文档

• VanBlog (mereith.com)

博客部署与迁移

配置环境

• 安装 docker

  • 在 Ubuntu 24.04 上安装 Docker 并运行 Docker 容器
  • Cannot find a valid baseurl for repo: centos-sclo-rh/x86_64 - andywu188 - 博客园 (cnblogs.com)
  • Error: Cannot find a valid baseurl for repo: centos-sclo-rh - Stack Overflow

• 无法启动 docker

  • Docker fails on Fedora 36: Failed to listen on docker.socket - Fedora Discussion (fedoraproject.org)

  • Cannot start docker daemon in CentOS7 - Stack Overflow

  • dockerd 是可以运行的

  • 我不理解，就改了一下 docker.socket 然后运行下面的命令就好了

    systemctl daemon-reload
    systemctl start docker.socket
    systemctl start docker
    

  • 甚至把 docker.socket 改回去，也没有报错了？

反向代理

• 宝塔面板

  • 【已完成】多个网站串了都指向一个网站，怎么解决？ - Linux面板 - 宝塔面板论坛 (bt.cn)

    • 开启 HTTPS 防窜站
    • 设置默认站点
    • 设置 SSL 证书 (https://blog.ilue.pp.ua/archives/nginx-proxy-manager------pao-qi-bao-ta-mian-ban-rang-ni-geng-you-ya-de-jin-xing-fan-xiang-dai-li)

  • 宝塔配置域名反向代理到ip+端口的接口地址 - HaimaBlog - 博客园 (cnblogs.com)

  • Nginx反向代理出现502 Bad Gateway问题的解决方案 - 秋窗 - 博客园 (cnblogs.com)

  • 宝塔反代到 https 时，报错

    SSL_do_handshake() failed (SSL: error:14094438:SSL routines:ssl3_read_bytes:tlsv1 alert internal error:SSL alert number 
    

    • 暂时解决不了问题，使用 http 直接进行主机内部的反代，绕过 SSL 问题

  • 宝塔反代前端内容不更新

    • 开启缓存，并设置缓存时间为 0 分钟
    • 部署常见问题 | VanBlog (mereith.com)

  • [Nginx Proxy Manager —— 抛弃宝塔面板让你更优雅的进行反向代理-煙花巷陌 (ilue.pp.ua)]

• 1Panel

  • 后面我换用 1Panel 基本没啥问题

备份迁移

• 需参考迁移指南，复制数据文件夹再执行安装脚本
• 备份与迁移 | VanBlog
  • 保存 /var/vanblog/data 内容即可。新机器上安装后，再用保存的 data 覆盖
  • VanBlog 脚本有备份指令，最好使用备份指令而非手动替换。
  • 且在新机器上安装时请正常流程进行安装，安装之后再进行导入工作，否则 VanBlog 可能启动不了。

博客写作

• 写文章时出现目录丢失问题
  • 有时候缩进不对就会导致下一部分的多级标题在目录里消失，但是编辑页面和渲染时不会有问题。
  • 测试了一下似乎是代码块整体有缩进，且之后没有文本内容直接到下一个多级标题就会出现这种情况。

博客功能

自动申请证书

caddy 自动申请证书

自定义页面

自定义页面中可以上传文件和文件夹，指定它们对应的路由。但是这些一旦设置了就修改不了了，想要修改只能把旧的删了重新设置一个新的。