Skip to content
blycr edited this page Jan 1, 2026 · 2 revisions

常见问题(FAQ)

本页面收集了使用LAN文件服务器时可能遇到的常见问题和解答,帮助您快速解决问题。

安装与启动

Q: 为什么服务器无法启动?

A: 可能的原因包括:

  • Python版本不兼容(需要Python 3.7+)
  • 端口被占用(服务器会自动检测并选择可用端口)
  • 配置文件格式错误
  • 共享目录不存在

Q: 如何查看服务器日志?

A: 服务器日志默认保存在lan_file_server.log文件中,您可以使用文本编辑器查看。

Q: 如何更改服务器端口?

A: 在config.json文件中修改server.port配置项,然后重启服务器。

Q: 服务器启动后,其他设备无法访问?

A: 请检查:

  • 所有设备是否在同一局域网内
  • 防火墙是否允许服务器端口访问
  • 服务器IP地址是否正确

配置与管理

Q: 如何修改用户名?

A: 用户名默认是blycr,可以在config.json文件中修改auth.username配置项,然后重启服务器。

Q: 密码是如何生成的?

A: 密码基于当前时间动态生成,格式为yyyymmddHHMM(例如:202512311430),支持当前时间前后5分钟内的密码。

Q: 如何添加新的文件类型支持?

A: 在config.py文件中修改WHITELIST_EXTENSIONS配置,添加新的文件扩展名。

Q: 如何更改共享目录?

A: 在config.json文件中修改server.share_dir配置项,然后重启服务器。

Q: 配置文件丢失了怎么办?

A: 重新运行服务器,会自动生成默认配置文件,然后您可以重新配置。

使用与功能

Q: 为什么有些文件不显示?

A: 服务器仅显示白名单内的多媒体文件类型,包括:

  • 图片:.jpg, .jpeg, .png, .gif, .bmp, .webp
  • 音频:.wav, .mp3, .ogg, .wma, .m4a, .flac
  • 视频:.mp4, .mov, .avi, .flv, .mkv, .wmv, .mpeg, .mpg

Q: 如何使用搜索功能?

A: 在页面顶部的搜索框中输入关键词,然后点击"搜索"按钮或按回车键,系统会显示所有文件名包含关键词的文件。

Q: 如何切换主题?

A: 点击页面右上角的主题切换按钮,可以在白天模式和夜间模式之间切换。

Q: 如何退出登录?

A: 点击页面右上角的"退出"按钮,即可退出登录。

移动端使用

Q: 移动端如何访问服务器?

A: 在移动端浏览器中输入服务器地址,例如:https://192.168.1.100:8000,然后输入用户名和密码登录。

Q: 移动端无法播放视频怎么办?

A: 请检查:

  • 视频格式是否受支持
  • 网络连接是否稳定
  • 浏览器是否支持该视频格式

Q: 移动端界面显示异常怎么办?

A: 请尝试刷新页面,或者使用最新版本的浏览器。

安全与隐私

Q: 我的文件安全吗?

A: 是的,所有文件都存储在本地,不会上传到云端,仅支持同一网络下的设备访问。

Q: 密码是如何存储的?

A: 当前版本使用基于时间的动态密码,不存储密码哈希,每次登录时根据当前时间生成密码并验证。

Q: 如何防止他人暴力破解密码?

A: 服务器内置了IP封禁机制,连续5次认证失败后,IP会被临时封禁5分钟(可配置)。

Q: 可以在公网中使用吗?

A: 不建议在公网中使用,LAN文件服务器设计用于局域网环境。如果需要从外部访问,建议使用VPN。

性能与优化

Q: 服务器运行缓慢怎么办?

A: 请尝试:

  • 增加索引缓存大小(在config.json中修改caching.index_cache_size
  • 减少共享目录中的文件数量
  • 关闭不必要的其他程序

Q: 搜索速度慢怎么办?

A: 请尝试增加搜索缓存大小(在config.json中修改caching.search_cache_size)。

Q: 如何优化大文件传输?

A: 服务器支持HTTP范围请求,已优化大文件传输。您可以尝试使用更快的网络连接。

故障排除

Q: 登录失败怎么办?

A: 请检查:

  • 用户名是否为blycr(或您在配置文件中设置的用户名)
  • 密码格式是否正确:yyyymmddHHMM(例如:202512311430)
  • 密码是否在当前时间前后5分钟内有效
  • 是否被IP封禁(等待5分钟后重试)
  • 配置文件是否正确

Q: 文件无法下载怎么办?

A: 请检查:

  • 网络连接是否稳定
  • 文件是否存在
  • 浏览器是否支持该文件类型下载

Q: 页面显示404错误怎么办?

A: 请检查:

  • URL是否正确
  • 文件或目录是否存在
  • 是否有权限访问

Q: 服务器频繁崩溃怎么办?

A: 请检查:

  • Python版本是否兼容
  • 日志文件中是否有错误信息
  • 系统资源是否充足

其他问题

Q: 如何获取项目更新?

A: 您可以通过以下方式获取项目更新:

  • 访问项目GitHub仓库
  • 关注项目的Release通知
  • 定期检查项目README.md文件

Q: 如何贡献代码?

A: 欢迎提交Issue和Pull Request来改进这个项目。请参考开发信息页面了解更多信息。

Q: 项目有许可证吗?

A: 是的,本项目采用MIT许可证。

Q: 可以商业使用吗?

A: 是的,根据MIT许可证,您可以商业使用本项目。

联系支持

如果您遇到了本页面未涵盖的问题,您可以:

  • 查看故障排除页面
  • 在GitHub项目页面提交Issue
  • 检查项目README.md文件获取更多信息

下一步

Clone this wiki locally