Skip to content

About

基于feffery-antd-component前端和websocket的网页聊天系统

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

局域网聊天工具

基于 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

WebSocket 协议

客户端 → 服务端

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

About

基于feffery-antd-component前端和websocket的网页聊天系统

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages