介绍#

Yet Another Chatroom Script，又称 YACS。是哔哩哔哩up主 -Valine- 制作的匿名聊天室，它以类似于Windows 98的风格进行展示，支持多个频道，添加管理员，发送文件和嵌入视频、图片，BBCode，CAPTCHA验证。使用 HTML、CSS、JS编写。受LE-CHAT-PHP启发，开发了此项目。

官方体验demo：https://chat.valine0x.icu/

截图#

部署#

1. 使用 venv 进行部署#

1
python -m venv .venv
2

3
# 在终端环境中激活虚拟环境
4
source .venv/bin/activate
5

6
# 然后把包安装到venv内部
7
pip install yacscript

创建一个配置文件进行编辑：

1
vim ./config.toml

你可以在配置文件查看所有可用的配置。

最后，你就可以在venv环境下运行服务器了。

2. 从源代码进行部署（UV）#

从源代码部署可以让你尝试到最新的功能，但这可能不稳定。要从源代码进行部署，你需要先安装uv。

1
# pip 安装 uv
2
pip install uv
3

4
# MacOS & Linux 安装 uv
5
curl -LsSf https://astral.sh/uv/install.sh | sh
6

7
# Windows 安装 uv
8
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

然后克隆仓库

1
git clone https://github.com/valine-dev/yacs.git
2
cd yacs

创建一个配置文件进行编辑。

1
vim ./config.toml

你可以在配置文件查看所有可用的配置。

最后，运行这个命令，它将会安装服务器，和所需要的依赖项等。

1
uv run yacs-run --config config.toml

3. Docker 部署#

⚠ 这个是博主写的一个简单Dockerfile，可能会存在一些问题，但是你可以根据自身需求进行修改。

1
FROM python:3.13.5-slim
2
WORKDIR /app/yacs/
3

4
RUN apt update && \
5
    apt install --no-install-recommends -y g++ libffi-dev build-essential \
6
    zlib1g-dev libjpeg-dev libfreetype6-dev && \
7
    rm -rf /var/lib/apt/lists/*
8

9
RUN pip install yacscript
10
RUN mkdir -p .config
11

12
COPY ./config.toml ./.config/config.toml
13

14
EXPOSE 8080
15
CMD ["yacs-run --config /app/yacs/config.toml"]

配置文件#

这个软件带有的所有配置如下所示

1
[flask]
2
# 在此您可以配置由Flask定义的内置配置项。
3
DEBUG = false # 调试模式。不要在生产环境中设置为 “true”！
4

5
[app]
6
# 该应用本身仅通过普通HTTP协议提供访问，但强烈不建议将其直接暴露于公共网络。应在应用前端使用支持TLS的反向代理。
7
ip = "0.0.0.0"
8
port = 8080
9

10
admin_phrase = "CHANGE_ME_ADMIN"
11
# user_phrase 如果为空，整个聊天室将会公开。
12
user_phrase = "CHANGE_ME"
13

14
log_level = "INFO"
15
timeout = 5000 # 以毫秒为单位，用于心跳包检测。
16

17
# 仅在应用被反向代理之后设置为 “true”！
18
# 确保 X-Forwarded-For 和 X-Forwarded-Host 标头是否正确设置！
19
proxy_fix = false
20

21
# socketio 连接
22
# 请务必在生产环境中设置合适的值。
23
cors_allowed_origins = "https://me.example"
24

25

26
[custom]
27
title = "The YACS"
28
motd = "Hello!\nRule No.1"
29

30
# 以下表情包将被显示网页上
31
emoticons = [
32
    "( ﾟ∀。)",
33
    "Insert Anything",
34
    "⭐"
35
]
36

37

38
[res]
39
path = "./resource" # 项目的根目录
40
size_max = 1024 # 以兆字节为单位，文件大小限制
41

42

43
[captcha]
44
length = 4
45
max_cache = 60
46
expire = 120 # CATCHA 过期时间，单位为秒
47

48
[captcha.options]
49
# CAPTCHA配置，最好不要全部启动，否则搞不好还会搞糊涂。
50
# Numbers: 带有数字
51
# lowercase: 带有小写字母
52
# uppercase: 带有大写字母
53
numbers = false
54
lowercase = true
55
uppercase = false
56

57
[db]
58
path = "./yacs.db"

例如，一个配置文件可能像这样：

1
[flask]
2
DEBUG = false
3

4
[app]
5
admin_phrase = "this-is-admin"
6
user_phrase = "hello"
7

8
[custom]
9
title = "My YACS Server"
10
motd = "Hello!\nRule No.1!"