ZmLan 使用教程

详细的安装和使用指南,帮助你快速上手 ZmLan 局域网聊天神器。

📋 目录

服务器安装

在使用 ZmLan 之前,需要先安装并启动服务器。

1.1 系统要求

1
硬件要求
  • 处理器:Intel Core i3 或更高
  • 内存:至少 2GB RAM
  • 存储空间:至少 10GB 可用空间
  • 网络:支持局域网连接
2
软件要求
  • 操作系统:Windows 10 / Windows 11(64位)
  • 浏览器:Chrome、Edge、Firefox 最新版

1.2 下载与解压

3
下载安装包

访问 ZmLan 官网下载页面,选择 Windows 版本下载:

  • 文件名:ZmLan-Server-V1.22S.zip
  • 文件大小:约 50MB
💡
建议安装在非系统盘(如 D:\),方便管理数据文件。
4
解压文件

右键点击压缩包,选择「解压到当前文件夹」或「解压到 ZmLan-Server」。

解压后的文件夹结构:

ZmLan-Server/
├── server.js          # 服务器主程序
├── package.json       # 依赖配置
├── 启动服务器.bat     # Windows启动脚本(双击运行)
├── app.js             # 客户端应用逻辑
├── chat.html          # 聊天界面
├── styles.css         # 样式文件
├── duankou.html       # 登录界面
├── player.html        # 播放器界面
├── houtai/            # 后台管理
├── tubiao/            # 图标文件
└── Font File/         # 字体文件

启动服务器

服务器启动非常简单,只需双击启动脚本即可。

1
双击启动脚本

打开服务器文件夹,找到 启动服务器.bat 文件,双击运行。

💡
如果出现安全警告,点击「更多信息」→「仍然运行」即可。
2
查看启动状态

启动后弹出命令行窗口,显示以下信息表示启动成功:

======================================
     ZmLan Chat Server - V1.22S
======================================

服务器运行在: http://0.0.0.0:8282
后台管理: http://localhost:8282/houtai

WebSocket 服务已启动
服务器启动成功!
3
防火墙设置

首次启动时,Windows 防火墙可能会弹出提示:

  • 选择「专用网络」和「公用网络」
  • 点击「允许访问」
⚠️
请确保 8282 端口未被其他程序占用,否则服务器无法启动。

连接服务器

服务器启动后,局域网内的设备可以通过浏览器访问。

1
获取服务器 IP

在服务器电脑上,按下 Win + R,输入 cmd,打开命令提示符:

ipconfig

找到 IPv4 地址,例如:192.168.1.100

💡
如果服务器和客户端在同一台电脑上,可用 localhost 访问。
2
访问登录页面

在浏览器中输入地址:

http://服务器IP:8282

例如:http://192.168.1.100:8282

3
用户登录

登录需要填写:

  • 用户名:自定义用户名
  • 密码:登录密码(可留空)
💡
首次登录时,如果用户名不存在,系统会自动创建新用户。
4
进入聊天界面

登录成功后,自动跳转到聊天界面:

  • 左侧:联系人列表和群组列表
  • 右侧:聊天窗口
  • 底部:消息输入框

聊天功能

ZmLan 提供完整的即时通讯功能。

1
发送文字消息

在左侧联系人列表中点击要聊天的用户,右侧显示聊天窗口。

在底部输入框中输入文字,按 Enter 或点击发送按钮发送。

  • 支持中文、英文、表情符号
  • Ctrl + Enter 换行
2
查看消息状态

每条消息右侧会显示发送状态:

  • :消息已发送
  • ✓✓:消息已送达
  • ✓✓+头像:消息已读
3
查看在线状态

联系人列表中会显示在线状态:

  • ● 在线:用户当前在线
  • ● 离线:用户当前离线

文件传输

ZmLan 支持高速文件传输,无需经过互联网。

1
发送文件

点击聊天窗口底部的文件图标,选择要发送的文件:

  • 支持任意格式文件
  • 支持大文件(GB级)
  • 支持多选文件
💡
大文件会自动分块上传,每块 5MB,支持断点续传。
2
上传进度

选择文件后,系统会自动开始上传,显示上传进度:

  • 进度条显示上传百分比
  • 显示上传速度
3
接收文件

收到文件消息后,会显示文件卡片,点击下载按钮即可下载。

⚠️
视频文件在移动端需要先下载才能播放。
4
文件管理

点击左侧导航栏的「文件」选项,查看你在服务器上保存的所有文件:

  • 按时间排序
  • 支持搜索
  • 支持批量下载

群组管理

ZmLan 支持创建群组,方便多人协作沟通。

1
创建群组

在左侧底部点击「创建群聊」按钮,填写群名称和添加成员:

  • 群名称:自定义群组名称
  • 成员:从在线用户中选择
  • 至少需要 2 名成员
2
群聊功能

群聊界面包含以下功能:

  • 群成员列表(右侧边栏)
  • @ 提及功能
  • 群文件共享
3
管理群成员

群管理员可以管理群成员:

  • 添加新成员
  • 移除现有成员

常见问题

Q1: 服务器启动失败怎么办?
  • 检查 8282 端口是否被其他程序占用
  • 检查防火墙是否允许 Node.js 访问网络
  • 查看命令行窗口的错误信息
Q2: 客户端无法连接服务器?
  • 确认服务器正在运行
  • 确认客户端和服务器在同一局域网
  • 确认服务器 IP 地址正确
  • 检查防火墙是否阻止了连接
Q3: 文件上传失败?
  • 检查服务器磁盘空间是否充足
  • 检查网络连接是否稳定
  • 尝试刷新页面重新上传
Q4: 消息发送后对方收不到?
  • 确认对方是否在线
  • 检查网络连接是否正常
  • 尝试刷新页面重新登录
Q5: 支持哪些浏览器?
  • Google Chrome(推荐)
  • Microsoft Edge
  • Mozilla Firefox
  • Safari