瓶子

Grampsweb#

Gramps Web 是一款开源的、基于 Web 的家谱协作平台。它是知名桌面级家谱软件 Gramps 的官方 Web 扩展版本，旨在让用户能够通过浏览器直接管理、共享和编辑家族历史数据。

Gramps Web 的核心理念是将桌面端强大的专业功能与现代云端的协作便利性相结合，让分布在世界各地的家族成员能够共同构建同一份家谱。

一、准备配置文件#

1.创建并进入项目目录 grampsweb#

1
mkdir -p ~/grampsweb && cd ~/grampsweb

2.创建用于持久化存储数据的子目录 data 和 media#

1
mkdir data media

3.新建 docker-compose.yml 文件#

1
nano docker-compose.yml

4.docker-compose.yml 文件粘贴以下内容：#

1
services:
2
  grampsweb:
3
    image: ghcr.io/gramps-project/grampsweb:latest
4
    container_name: grampsweb
5
    restart: always
6
    environment:
7
      GRAMPSWEB_TREE: "Family Tree 1"  # 默认数据库名称
8
      GRAMPSWEB_CELERY_CONFIG__broker_url: "redis://redis:6379/0"
9
      GRAMPSWEB_CELERY_CONFIG__result_backend: "redis://redis:6379/0"
10
      GRAMPSWEB_RATELIMIT_STORAGE_URI: "redis://redis:6379/1"
11
    volumes:
12
      - ./data:/app/data        # 数据库和媒体文件存储
13
      - ./index:/app/index      # 全文搜索索引
14
    ports:
15
      - "8080:5000"               # 访问端口，可根据需要修改
16
    depends_on:
17
      - redis
18

19
  redis:
20
    image: redis:alpine
21
    container_name: grampsweb_redis
22
    restart: always

二、启动服务#

1.在终端进入 grampsweb 目录并运行根据配置文件，在后台启动并运行整套服务：#

1
cd grampsweb && docker-compose up -d

2.启动后，访问 http://localhost:8080。首次登录时，系统会引导创建管理员账户。#

GrampsWeb

三、部署中途遇到的问题#

查询指令：

1
docker ps

Gramps Web 官方镜像默认的服务端口实际上是 5000（可以看到容器信息里单独列出了 5000/tcp）。因为映射错了容器内部端口，所以访问 8080 时，流量被发往了容器内一个“空”的 80 端口。

解决方法：

进入目录：

1
cd ~/grampsweb

编辑文件：

1
nano docker-compose.yml

修改内容：

1
ports:
2
  - "8080:5000"

如果这篇文章对你有帮助，欢迎分享给更多人！

Gramps Web 家谱协作平台

bk.333797.xyz

作者

瓶子

发布于

2026-03-01

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

OpenClaw 部署（Ubuntu）

Immich 云相册

瓶子的小站