使用 Halloy 连接

本页从第一次打开客户端开始。已有 Halloy 的用户可以跳到「找到配置文件」。配置使用 Halloy 2026.9 支持的字段，不依赖新版图形配置编辑器。

连接信息

服务器 irc.sonnzy.net，端口 6697，开启 TLS。当前使用受信机构签发的证书，不需要额外导入证书；游客可以直接连接。

1. 安装 Halloy

从 Halloy 官方安装说明选择与你系统对应的安装包。不要在非官方页面输入 IRC 密码。

• Windows：使用官方发布页的安装包；已使用 winget 的用户也可运行 winget install squidowl.halloy。
• macOS：使用官方发布包；Homebrew 用户可运行 brew install --cask halloy。
• Linux：按官方安装说明选择发行版软件包、Flatpak 或发布包。

安装后打开一次 Halloy，生成默认配置文件。默认连接的其他网络与 sonnzyIRC 不是同一个账户体系。

2. 找到配置文件

Halloy 使用 config.toml。先备份现有文件，不要用本页示例覆盖你已经配置的其他网络。

系统	配置位置
Windows	%AppData%\halloy\config.toml，可在文件资源管理器地址栏打开 %AppData%\halloy
macOS	~/Library/Application Support/halloy/config.toml，或你已使用的 ~/.config/halloy/config.toml
Linux 原生安装	$XDG_CONFIG_HOME/halloy/config.toml；未设置该变量时通常是 ~/.config/halloy/config.toml
Linux Flatpak	在 ~/.var/app/org.squidowl.halloy/config 内寻找首次启动生成的 config.toml；以该安装实际生成的位置为准

用纯文本编辑器打开文件，在现有内容末尾添加下面的完整段落。一个文件里只保留一个 [servers.sonnzyIRC]，不要重复粘贴。

3. 添加首次连接配置

[servers.sonnzyIRC]
nickname = "YourNick"
server = "irc.sonnzy.net"
port = 6697
use_tls = true
autoconnect = true
channels = ["#sonnzy"]

下载首次连接配置，适合新建配置或复制其中的服务器段；不是覆盖已有配置的要求。

把 YourNick 换成你想用的昵称；其他参数先保持原样。首次以游客连接，不添加 SASL、nick_password 或服务器 password。channels 表示连接后自动加入的频道。

配置使用默认的受信证书校验。请勿添加跳过校验的选项；遇到证书警告时按证书验证排查，不要继续输入密码。

4. 加载配置并连接

保存 config.toml，从 Halloy 侧栏菜单选择重新加载配置（Reload Configuration）。若配置报错，先检查提示中的行号、引号和重复段落；尚未成功加载时不要继续下面的步骤。

上面的 autoconnect = true 会在配置加载后自动连接。连接成功的标志是：侧栏出现 sonnzyIRC，服务器窗口显示欢迎消息，并打开 #sonnzy 频道。

如果暂时关闭了自动连接，也可以在侧栏选中已配置的 sonnzyIRC 服务器，在输入框执行 /reconnect。不要只用临时连接 URL 代替配置，否则下次启动不一定自动恢复。

5. 发送第一条消息

如果没有自动打开频道，先在 sonnzyIRC 服务器窗口执行 /join #sonnzy。然后点击侧栏的 #sonnzy，在底部输入框输入文字，按 Enter 发送。自己发出的消息应出现在该频道的消息区；若有权限错误，看频道问题。

加入朋友的频道：

/join #example

#example 要换成实际频道名。如果频道里暂时没人回复，不等于发送失败。

6. 注册自己的昵称

在 sonnzyIRC 的输入框逐条执行，开头不要加空格：

/nick YourNick
/msg NickServ REGISTER YOUR_PASSWORD

把昵称和密码换成自己的值。密码使用独立密码并妥善保存，不能照抄占位符；注意 NickServ 的成功回复。本网络目前不强制邮箱验证；不用注册第二个网站账户。

7. 设置下次自动登录

注册成功后，准备一个只有自己可读的纯文本密码文件：第一行只放 IRC 密码，不加引号，不添加 password = 前缀。不要把该文件上传到仓库或分享给别人。

然后在现有的 [servers.sonnzyIRC] 段内添加以下三项，而不是再次创建同名段：

sasl.plain.username = "YourNick"
sasl.plain.password_file = "/ABSOLUTE/PATH/sonnzy-password.txt"
sasl.plain.disconnect_on_failure = true

将路径和账户名换成真实值；nickname 也与账户名一致。Linux/macOS 可用 chmod 600 限制密码文件权限；Windows 用文件安全属性限制其他用户读取。Windows 路径同样可以使用单引号。

下载注册后配置模板，其中的路径都需要替换。不要同时设置 sasl.plain.password、password_file、password_command 等多个密码来源。

保存、重新加载后，在 sonnzyIRC 窗口执行 /quit 断开，再在已配置的 sonnzyIRC 服务器执行 /reconnect（或通过侧栏服务器连接操作重新连接）。看到认证成功提示后输入：

/msg NickServ INFO

应看到自己的账户信息。SASL 失败就断开是预期保护，不要关掉这项保护来掩盖错误；检查账户名、密码文件路径和文件第一行。

日常操作速查

想做什么	在 sonnzyIRC 输入框执行
查找频道	/list，也可用 /list *关键词* 筛选
加入频道	/join #example
打开私聊	/query YourFriend
发送私信	/msg YourFriend 你好
查看对方信息	/whois YourFriend
离开频道	/part #example
读取最近的频道历史	/raw HISTORY #example 50
断开当前客户端	/quit 下次见
重新连接已配置的网络	/reconnect

Halloy 通常可向上滚动加载支持的历史；可读范围仍以历史策略为准。关闭某个频道面板、离开频道和断开整个网络不是同一个操作。

出错时先看哪里

• 没有 sonnzyIRC 侧栏项：检查配置是否成功重新加载，或是否编辑了另一套安装的配置文件。
• 无法解析地址 / 连接超时：检查服务器字段、网络和 DNS，见连接排错。
• 证书校验失败：检查地址、系统时间及客户端版本，不要跳过验证。
• 昵称被占用：自己的注册昵称用 SASL；别人的昵称换一个。
• SASL 失败：确认文件可读、第一行正确，并且没有多个密码来源。
• 反复断线：查看 sonnzyIRC 服务器窗口的错误原文，不要把密码或完整聊天记录贴出来。

更多细节见 Halloy 配置说明、密码文件说明和命令说明。