很多人都遇到过这样的场景：

• 家里几台设备想快速互传信息
• 办公室临时需要一个局域网聊天室
• 学校机房想做一个多人协作消息板
• 树莓派、小主机、NAS 想变成聊天服务器
• 不想依赖微信、QQ、互联网

其实，只需要一个 Python 文件，就能搭建一个：

• 局域网聊天室
• 多设备实时通信网页
• Markdown 聊天系统
• 支持手机访问的聊天平台

而且：

• 不需要数据库
• 不需要安装复杂环境
• 不需要公网
• 不需要云服务器

只要同一个 WiFi 即可。

一、项目效果

聊天室具备：

• 实时消息刷新
• 多人在线聊天
• 在线人数显示
• Markdown 消息渲染
• 不同用户不同颜色
• 手机 / 平板 / PC 全兼容
• 浏览器直接访问

例如：

http://192.168.1.23:8000

局域网其他设备打开即可进入聊天室。

二、普通用户篇：如何使用

这一部分适合：

• 非程序员
• 想快速部署
• 想家庭 / 办公室使用
• 想做局域网聊天

的用户。

1. 安装 Python

前往：

Python 官网

下载安装 Python 3。

安装时一定勾选：

Add Python to PATH

2. 保存代码

把聊天服务器代码保存为：

lan_chat_server.py

3. 启动服务器

双击运行，或者命令行：

python lan_chat_server.py

看到：

局域网聊天室启动成功

本机访问：
http://127.0.0.1:8000

局域网访问：
http://192.168.1.23:8000

说明已经成功。

4. 其他设备加入聊天

只需要：

• 手机
• 平板
• 电脑

连接同一个 WiFi。

然后浏览器打开：

http://192.168.1.23:8000

即可进入聊天室。

5. 支持 Markdown

发送：

# 标题

**粗体**

```python
print("hello")
```

会自动渲染成富文本。

6. 在线人数实时变化

聊天室顶部会显示：

在线人数：5

打开页面自动上线。

关闭页面一段时间后自动离线。

7. 不同用户不同颜色

每个昵称会自动获得不同颜色：

• 蓝色
• 紫色
• 绿色
• 橙色

聊天时更容易区分消息来源。

开发者篇：代码设计解析

1. 整体架构

整个系统实际上只有：

Python HTTP Server
+
HTML
+
CSS
+
JavaScript

没有使用：

• Flask
• Django
• Node.js
• Vue
• React

因此非常轻量。

2. Python 作为 Web Server

核心：

fromhttp.serverimportHTTPServer
fromhttp.serverimportBaseHTTPRequestHandler

Python 标准库自带 HTTP 服务能力。

服务器：

server=HTTPServer(
    ('0.0.0.0', 8000),
ChatHandler
)

其中：

0.0.0.0

表示：

监听所有网卡。

因此局域网设备可以访问。

3. HTTP 接口设计

整个聊天室只有几个接口：

这是一个非常典型的：

REST 风格

轻量 API。

4. 消息存储

消息直接保存在内存：

messages= []

每条消息：