私人社交群组平台Zusam

发表于 2022-11-09 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2k 阅读时长 ≈ 2 分钟

Zusam 是与朋友和家人共享消息、照片、视频、链接的私人群组平台软件。

本文完成于 8 月中下旬，撰写时的版本为 0.5.1，发稿时最新的版本为 0.5.3

什么是 Zusam ？

Zusam (/tsuˈzam/) 是一种免费、开源的方式，可以为朋友们自托管私人论坛。Zusam 由一个用 PHP 编写的服务器、一个 REST API 和一个轻量级的 webapp 组成，可扩展且易于安装。目标是为自托管私人社交团体提供一种稳定、可扩展、轻量级和用户友好的方式。

不想安装的话可以去官方的演示站点看看：https://demo.zusam.org

账号：zusam，密码：zusam。实例每小时重置一次。

安装

在群晖上以 Docker 方式安装。

如果在在注册表中搜索 zusam ，会返回一堆混乱的东西，而且也找不到我们要的东西

所以我们进入 映象 –> 新增 –> 从 URL 添加

在 URL 中输入 zusam/zusam，然后点 新增 按钮

自动会开始下载

下载完成后，会在 映象 中看到下载的镜像

卷

在 docker 文件夹中，创建一个新文件夹 zusam，并在其中建一个子文件夹 data

文件夹	装载路径	说明
`docker/zusam/data`	`/zusam/data`	存放设置、数据库、上传文件等

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`5480`	`8080`

环境

可变	值
`INIT_USER`	第一个用户的账号
`INIT_PASSWORD`	第一个用户的密码

如果您不指定INIT_USER和 INIT_PASSWORD，它们将默认为zusam，登录后，这个密码是可以修改的

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 zusam 和 子目录
mkdir -p /volume2/docker/zusam/data

# 进入 zusam 目录
cd /volume2/docker/zusam

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name zusam \
   -p 5480:8080 \
   -v "$(pwd)/data:/zusam/data" \
   -e INIT_USER=<第一个用户的账号> \
   -e INIT_PASSWORD=<第一个用户的密码> \
   zusam/zusam:0.5.1

# 示例
docker run -d \
   --restart unless-stopped \
   --name zusam \
   -p 5480:8080 \
   -v "$(pwd)/data:/zusam/data" \
   -e INIT_USER=wbsu2003@gmail.com \
   -e INIT_PASSWORD=123456 \
   zusam/zusam:0.5.1

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  zusam:
    image: zusam/zusam:0.5.1
    container_name: zusam
    restart: unless-stopped
    ports:
      - 5480:8080
    volumes:
      - ./data:/zusam/data
    environment:
      - INIT_USER=wbsu2003@gmail.com
      - INIT_PASSWORD=123456

然后执行下面的命令，在 portainer 中执行也是可以的

# 新建文件夹 zusam 和 子目录
mkdir -p /volume2/docker/zusam/data

# 进入 zusam 目录
cd /volume2/docker/zusam

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d