核心用法
lan-media-server 是一个轻量级Node.js静态文件服务器,用于在AI工作空间与用户之间建立局域网文件共享通道。当用户通过不支持内嵌媒体的渠道(如webchat、CLI、SSH)与AI交互时,Agent可将截图、图片或文档放入共享目录,生成HTTP链接发送给用户访问。
部署流程极简:单条命令bash scripts/setup.sh即可完成目录创建、服务安装、systemd用户服务注册及启动。默认监听18801端口,文件存放于$HOME/projects/shared-media,支持通过环境变量自定义端口和路径。
显著优点
1. 渠道兼容性:彻底解决终端、聊天界面等无图形化输出环境的媒体展示难题
2. 运维友好:systemd用户服务管理,无需root权限,支持标准日志查看和状态监控
3. 即开即用:无复杂配置,文件放入目录即可通过http://<LAN_IP>:18801/<filename>访问
4. 资源轻量:Node.js驱动,内存占用极低
潜在局限
- 无认证机制:任何知道URL的局域网用户均可访问,不适合敏感文件
- 扁平目录结构:无子目录组织,需依赖描述性文件名管理
- 局域网限制:仅限内网访问,无公网穿透能力
- 单点依赖:服务停止后链接失效,需配合systemd确保持久化
适合人群
本地AI开发环境用户、需要向CLI/webchat用户展示可视化结果的技术人员、注重部署效率的轻量级场景。
常规风险
主要风险在于误放敏感文件至共享目录导致信息泄露,以及未正确配置防火墙时局域网暴露范围过大。建议配合网络隔离策略使用。