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

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
# 新建文件夹 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 文件

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

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 zusam 和 子目录
mkdir -p /volume2/docker/zusam/data

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

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

# 一键启动
docker-compose up -d

运行

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

登录

用在环境变量中设定的 INIT_USERINIT_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