基于 Dash + Feffery 组件库 + WebSocket 的仿微信桌面版局域网聊天应用。
两个独立进程:
| 进程 | 端口 | 技术栈 | 说明 |
|---|---|---|---|
server.py |
8765 | websockets |
WebSocket 服务端,处理登录/消息转发/上下线广播 |
app.py |
8053 | Dash + fac + fuc | 浏览器客户端,仿微信 UI |
# 安装依赖
pip install -r requirements.txt
# 启动服务端
python server.py
# 另开终端启动客户端
python app.py
# 浏览器访问
http://127.0.0.1:8053局域网其他设备访问时,将
config.py中WS_CLIENT_HOST和DASH_HOST改为本机 LAN IP。
- 登录/登出 — 输入昵称登录,重复昵称被拒;退出登录发送
logout消息,WebSocket 连接保持存活 - 在线状态 — 实时显示在线用户列表,用户上下线自动广播
- 文本聊天 — 仿微信气泡布局,左对方右自己;支持回车发送
- 图片发送 — 点击图片按钮上传并发送,接收方直接预览
- 文件发送 — 点击文件按钮上传并发送,接收方可下载
- 未读计数 — 联系人右侧显示未读消息数,点击会话自动清零
- 登录状态持久化 — 使用
localStorage记住用户名
F:\chatWebsocket\
├── config.py # 地址端口、上传限制、消息类型常量
├── server.py # WebSocket 服务端(消息路由 + 广播)
├── app.py # Dash 入口 + /upload 上传路由
├── chat/
│ ├── layouts.py # 页面布局(登录页、聊天页)
│ └── callbacks.py # 所有 Dash 回调函数
├── assets/
│ └── wechat.css # 仿微信样式(气泡/侧栏/输入区)
├── uploads/ # 上传文件存储目录(gitignored)
├── requirements.txt
└── .gitignore
| type | 字段 | 说明 |
|---|---|---|
login |
username |
登录请求 |
logout |
— | 登出(释放用户名,连接保持) |
p2p_msg |
from, to, content, msg_type, time, file_name |
点对点消息 |
| type | 字段 | 说明 |
|---|---|---|
login_success |
username, online_users |
登录成功,返回用户名和在线列表 |
login_fail |
reason |
登录失败原因 |
p2p_msg |
from, content, msg_type, time, file_name |
转发消息(含文件原名) |
user_online |
username, online_users |
用户上线广播 |
user_offline |
username, online_users |
用户下线广播 |
error |
message |
错误信息(如目标离线) |
- FefferyWebSocket — 使用
fuc.FefferyWebSocket组件替代原生WebSocket+ clientside,latestMessage事件驱动接收,operation/message属性控制发送 - 上传组件 —
AntdUpload纯按钮式上传(无预览列表),上传响应携带fileName实现原始文件名传递 - 消息本地自显 — 发送方在本地 Store 中立即追加消息(不等待服务端回显),接收方通过 WS 转发显示
- 退出不断连 —
logout回调发送{"type":"logout"}消息而非operation="disconnect",确保再次登录无需重建 WebSocket 连接
- Python 3.12+
- dash 4.2.0
- feffery-antd-components (fac)
- feffery-utils-components (fuc) >= 0.3.6
- websockets 16.0