从0到1：使用Docker快速部署Shout IRC服务器的简明教程

【免费下载链接】shout Deprecated. See fork @ https://github.com/thelounge 项目地址: https://gitcode.com/gh_mirrors/sh/shout

Shout是一款功能强大的自托管Web IRC客户端，让你能够通过浏览器轻松连接和管理IRC网络。本教程将带你用Docker在几分钟内完成Shout IRC服务器的部署，即使你是Docker新手也能轻松上手。

📋 准备工作：确保环境就绪

在开始部署前，请确认你的系统已安装以下工具：

• Docker Engine（推荐版本18.06+）
• Docker Compose（用于简化多容器部署）

如果尚未安装Docker，可以参考官方文档进行安装。安装完成后，通过以下命令验证：

docker --version
docker-compose --version

🚀 步骤1：获取Shout项目代码

首先克隆Shout项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/sh/shout
cd shout

🐳 步骤2：使用Docker Compose一键部署

Shout项目已内置Docker支持，通过项目根目录下的docker-compose.yml文件可以快速启动服务。该配置文件定义了服务端口映射（9000端口）和构建规则。

执行以下命令启动服务：

docker-compose up -d

这个命令会：

1. 基于项目根目录的Dockerfile构建镜像
2. 创建非root用户"shout"运行服务
3. 将容器的9000端口映射到主机的9000端口
4. 使用/home/shout/data目录存储应用数据

🔧 步骤3：访问与配置Shout

服务启动后，打开浏览器访问：

http://localhost:9000

首次访问时，系统会提示创建管理员账户。按照指引完成设置后，你就可以：

• 添加IRC网络连接
• 创建和管理频道
• 自定义界面主题（项目提供了crypto.css、morning.css等主题）

⚙️ 进阶配置：自定义你的Shout服务器

修改默认端口

如果需要修改默认的9000端口，可以编辑docker-compose.yml文件，修改ports配置：

ports:
  - "8080:9000"  # 将主机8080端口映射到容器9000端口

持久化数据

默认情况下，Shout数据存储在容器内部。为确保数据持久化，可以修改Dockerfile中的SHOUT_HOME环境变量，将数据目录挂载到主机：

ENV SHOUT_HOME /path/on/host/to/data

📝 常见问题解决

服务无法访问？

• 检查Docker服务是否正常运行：systemctl status docker
• 确认端口未被占用：netstat -tuln | grep 9000
• 查看容器日志：docker-compose logs shout

如何更新Shout？

git pull
docker-compose down
docker-compose up -d --build

🎉 总结

通过Docker部署Shout IRC服务器只需简单几步，让你快速拥有一个功能完善的Web IRC客户端。Shout的核心优势在于其直观的Web界面和丰富的自定义选项，项目源码中的src/server.js和src/clientManager.js实现了主要的服务端逻辑，而client/js/shout.js则负责前端交互。

现在你可以邀请朋友一起使用你的IRC服务器，享受实时聊天的乐趣了！如果需要更多高级功能，可以查阅项目的官方文档或探索src/plugins目录下的插件系统。

【免费下载链接】shout Deprecated. See fork @ https://github.com/thelounge 项目地址: https://gitcode.com/gh_mirrors/sh/shout