私人社交群组平台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

端口

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

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

环境

如果您不指定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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

也可以用 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
1
2
3
4
5
6
7
8
9
10
11
12
13
14

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

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

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

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

# 一键启动
docker-compose up -d
1
2
3
4
5
6
7
8
9
10

运行

在浏览器中输入 http://群晖IP:5480 就能看到主界面

登录

用在环境变量中设定的 INIT_USER 和 INIT_PASSWORD 登录

分组

右上角可以新建分组，默认是 zusam

老苏随便建了几个

设置

左上角是设置，可以修改用户密码等，目前不支持中文

邀请

每个组都有邀请链接

其他用户在打开邀请链接时会被要求先注册

帖子

右下角的笔可以新建一个帖子

你可以插入三种类型的文件，图片、视频和 pdf 文档

未来会通过插件，增加对 markdown 等更多格式的支持；

老苏试了一张图片

进入帖子

点帖子的右下角的三个点，在弹出菜单中可以进行编辑、分享、删除等操作

在手机上运行的效果蛮不错的

和 Flarum 相比，Zusam 功能少，但更简单。目前 Zusam 仍处于早期开发阶段，有这方面需求可以装一个玩玩。

参考文档

zusam/zusam: Private groups to share messages, photos, videos, links with friends and family.
地址：https://github.com/zusam/zusam