linuxserver/pidgin

linuxserver/pidgin 镜像文档

镜像概述

linuxserver/pidgin是基于Pidgin聊天程序的Docker化实现，Pidgin允许用户同时登录多个不同的聊天网络，实现单一界面管理多平台聊天账号。该镜像包含默认聊天插件及多种第三方插件，并集成Firefox浏览器以处理验证码或预授权流程，提供Web访问方式。

核心功能与特性

多聊天网络支持

支持多种聊天协议及平台，包括：

• 默认插件：XMPP、IRC、Bonjour、Gadu-Gadu、GroupWise、SIMPLE、Zephyr等
• 第三方插件（需参考对应文档配置）：
  • ***（由https://github.com/EionRobb/purple-***%E6%8F%90%E4%BE%9B%EF%BC%89
  • ***（由https://github.com/dequis/purple-***%E6%8F%90%E4%BE%9B%EF%BC%89
  • Hangouts/Google Talk（由https://github.com/EionRobb/purple-hangouts%E6%8F%90%E4%BE%9B%EF%BC%89
  • ICQ (WIM)（由https://github.com/EionRobb/icyque%E6%8F%90%E4%BE%9B%EF%BC%89
  • Instagram（由https://github.com/EionRobb/purple-instagram%E6%8F%90%E4%BE%9B%EF%BC%89
  • Rocket.chat（由https://github.com/EionRobb/purple-rocketchat%E6%8F%90%E4%BE%9B%EF%BC%89
  • Slack（由https://github.com/EionRobb/slack-libpurple%E6%8F%90%E4%BE%9B%EF%BC%89
  • ***（由https://github.com/majn/***-purple%E6%8F%90%E4%BE%9B%EF%BC%89%E7%AD%89

集成工具

内置Firefox浏览器，右键桌面即可启动，用于处理第三方插件所需的验证码输入或预授权操作。

注意事项

• 第三方插件可能需要额外配置（如生成OAuth令牌），需参考其官方文档
• 第三方插件处于持续开发中，部分原生功能可能无法完美运行

使用场景

适用于需要在单一界面管理多个聊天账号的用户，如开发者、运维人员及多平台社交用户，尤其适合通过Docker快速部署Pidgin的场景。

使用方法与配置说明

部署示例

Docker Run命令

bash
docker run -d \
  --name=pidgin \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/pidgin:latest

参数说明

环境变量

• PUID=1000：运行容器的用户ID（建议设置为当前用户ID）
• PGID=1000：运行容器的组ID（建议设置为当前用户组ID）
• TZ=Etc/UTC：时区设置（如Asia/Shanghai表示上海时区）

端口映射

• 3000:3000：应用内部端口
• 3001:3001：Web访问端口（HTTPS）

卷挂载

• /path/to/config:/config：配置文件存储目录，映射本地目录以持久化配置

性能配置

• --shm-size="1gb"：共享内存大小设置，建议1GB以保证应用稳定运行

应用访问与配置

访问地址

容器启动后，通过以下地址访问Pidgin：
https://<yourhost>:3001/

插件使用

• 第三方插件可能需要额外配置（如API密钥、OAuth令牌等），需参考对应插件文档
• 处理验证码或预授权时，右键桌面启动Firefox浏览器完成操作

重启策略

建议使用--restart unless-stopped确保容器异常退出后自动重启，除非手动停止。