H

Haven

774 stars·隐私保护·已提供 SHA-256 校验码,下载后可自行核对文件完整性

一个注重隐私的开源博客应用,支持自托管、RSS 订阅和媒体分享。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

私人博客,只给朋友看,没广告没跟踪。

核心功能

  • 隐私优先,仅受邀用户可注册
  • Markdown 实时预览编辑器
  • 内置 RSS 阅读器
  • 图片自动缩放节省带宽
  • 自定义 CSS 和字体

避坑指南

  • •Heroku 部署不适合生产使用(图片 24 小时后消失),且免费方案已取消,AWS 部署较复杂,需等待约 20 分钟,失败可运行清理脚本,请务必在环境变量中设置强密码,避免默认凭据泄露

适用场景

  • 个人/家庭私密博客,与亲友分享生活
  • 小团队内部知识库或日志

详细介绍

Haven 是一个基于 Ruby on Rails 的私有博客应用,重点在于隐私、易用性和低带宽。它提供 Markdown 实时预览编辑、内置 RSS 阅读器、媒体支持(图片、视频、音频)和可自定义 CSS。用户只能通过邀请加入,杜绝垃圾信息。支持通过 Docker、PikaPods、AWS、Heroku 或树莓派自行托管,并提供私人 RSS 订阅源供好友使用。

常见问题与排障 (2)

操作指南
如何在GitHub Actions中构建多架构Docker镜像(包括ARM64)?

在您的工作流程中添加 QEMU 和 Buildx 步骤,然后在构建推送操作中指定平台。使用以下模板:

build-image:
  runs-on: ubuntu-latest
  steps:
    - name: 检出代码
      uses: actions/checkout@v4
    - name: 设置 QEMU
      uses: docker/setup-qemu-action@v3
    - name: 设置 Docker Buildx
      uses: docker/setup-buildx-action@v3
    - name: 登录 GitHub 容器仓库
      uses: docker/login-action@v3
      with:
        registry: ghcr.io
        username: ${{ github.repository_owner }}
        password: ${{ secrets.GITHUB_TOKEN }}
    - name: 构建并推送镜像
      uses: docker/build-push-action@v6
      with:
        context: .
        platforms: linux/amd64,linux/arm64
        push: true
        tags: your-tag

请将 your-tag 替换为实际标签,并根据需要调整仓库/凭据。如果有标签步骤,请添加 needs: create-tag。

来源 Issue #108
故障排除
如何修复更新到最新镜像后 Haven Docker 陷入重启循环并提示 "A server is already running. Check /app/tmp/pids/server.pid" 的问题?

PostgreSQL 的 database "haven" already exists 消息通常是无害的。重启问题是由残留的 Puma PID 文件引起的,而图片/自定义内容丢失通常是因为存储路径从 /storage 变更为了 /app/storage。

1. 编辑 docker-compose.yml,更新 Haven 的卷挂载:

volumes:
  - ./storage:/app/storage

替换掉之前所有的 ./storage:/storage 挂载。

2. 重新创建容器并删除残留的 PID 文件:

docker compose down
docker compose rm -f haven
docker compose up -d

如果 PID 错误仍然出现,可在容器短暂运行期间直接将其删除:

docker exec -it haven-haven-1 rm -f /app/tmp/pids/server.pid
docker compose restart haven

作为临时解决方案,可以将镜像固定为之前正常工作的版本:

image: ghcr.io/havenweb/haven:e18a854

来源 Issue #164

标签

blogprivacyruby-on-railsself-hostedrssmarkdown

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

推荐使用 Docker:克隆仓库后运行 `docker compose up`

4

浏览器访问 http://localhost:3000

5

通过环境变量设置管理员邮箱和密码,完成初始化

安装指引
  1. 推荐使用 Docker:克隆仓库后运行 `docker compose up`
  2. 浏览器访问 http://localhost:3000
  3. 通过环境变量设置管理员邮箱和密码,完成初始化
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止 Docker 容器或删除托管服务(如 PikaPods 中的应用)即可。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议MIT
最后更新2026-10-15 06:37:12
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

2 FAQs

相似推荐