快速开始

使用我们的一键安装脚本，几分钟内启动并运行 SirrChat。

系统要求

硬件要求

系统要求:
  操作系统: Ubuntu 20.04+ / macOS 12+ / CentOS 8+
  CPU: 2核以上
  内存: 2GB 最低（推荐 4GB）
  存储: 20GB SSD
  网络: 100Mbps

软件依赖:
  Go: 1.24+（仅编译需要）
  Git: 最新版
  Make: 最新版

所需端口

确保以下端口可用：

端口	服务	必需
25	SMTP	可选
587	Submission	是
465	SMTPS	可选
993	IMAPS	是
143	IMAP	可选
8825	SMTP Alt	是

一键安装

使用单条命令安装和配置 SirrChat：

# 下载并运行安装脚本
curl -sSL https://raw.githubusercontent.com/mail-chat-chain/mailchatd/main/start.sh | bash

自动安装程序将执行以下操作：

1. 下载和安装 为您的平台下载 sirrchatd 二进制文件
2. 域名配置 - 设置您的邮件域名
3. DNS 提供商设置 - 从 15 种支持的提供商中选择
4. TLS 证书 - 自动 ACME DNS-01 挑战设置
5. 服务管理 - 创建并启动 systemd 服务

支持的 DNS 提供商

安装脚本支持以下 DNS 提供商的自动 TLS 证书配置：

提供商	类型	认证方式
Cloudflare	全球 CDN	API Token
Amazon Route53	AWS DNS	Access Key + Secret
DigitalOcean	云端 DNS	API Token
Google Cloud DNS	GCP DNS	服务账户 JSON
Vultr	云端 DNS	API Key
Hetzner	欧洲 DNS	API Token
Gandi	域名注册商	API Token
Namecheap	域名注册商	API 凭证
+ 7 个更多	各种	各种

手动安装

如果您更喜欢手动安装：

1. 从源码构建

# 克隆仓库
git clone https://github.com/mail-chat-chain/mailchatd.git
cd sirrchatd

# 构建二进制文件
make build

# 验证安装
./build/sirrchatd --help

2. 启动服务器

# 运行邮件服务器
./build/sirrchatd run

# 或者使用 start.sh 脚本自动配置
./start.sh

第一步

创建用户账户

# 创建用户凭证
sirrchatd creds create user@example.com

# 生成密码哈希（如果使用密码认证）
sirrchatd hash mypassword

配置您的邮件客户端

使用任何标准邮件客户端（Thunderbird、Outlook、Apple Mail 等），配置如下：

接收邮件 (IMAP):

• 服务器: your-domain.com
• 端口: 993
• 安全性: SSL/TLS
• 用户名: user@example.com
• 密码: your-password

发送邮件 (SMTP):

• 服务器: your-domain.com
• 端口: 587
• 安全性: STARTTLS
• 用户名: user@example.com
• 密码: your-password

发送您的第一封邮件

配置完成后，您就可以通过 SirrChat 服务器发送和接收邮件了！

下一步

• 部署指南 - 生产环境部署最佳实践
• 配置说明 - 详细的配置选项
• 认证系统 - 设置区块链认证

故障排查

常见问题

端口已被占用:

# 检查哪个进程在使用端口
sudo lsof -i :25
sudo lsof -i :587

# 停止冲突的服务
sudo systemctl stop postfix  # Postfix 示例

TLS 证书问题:

# 检查 DNS 配置
sirrchatd dns check

# 验证 DNS 记录
sirrchatd dns export

服务无法启动:

# 检查服务状态
sudo systemctl status sirrchatd

# 查看详细日志
sudo journalctl -u sirrchatd -n 50

获取帮助

• 查看 常见问题
• 查看 详细文档
• 在 GitHub 上报告问题

---

恭喜！ 您现在拥有一个正常工作的 SirrChat 服务器。🎉