Haven
一个注重隐私的开源博客应用,支持自托管、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。
故障排除如何修复更新到最新镜像后 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标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
推荐使用 Docker:克隆仓库后运行 `docker compose up`
浏览器访问 http://localhost:3000
通过环境变量设置管理员邮箱和密码,完成初始化
- 推荐使用 Docker:克隆仓库后运行 `docker compose up`
- 浏览器访问 http://localhost:3000
- 通过环境变量设置管理员邮箱和密码,完成初始化
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载,并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止 Docker 容器或删除托管服务(如 PikaPods 中的应用)即可。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
2 FAQs