first commit

2026-04-19 05:07:07 +08:00
commit 734c00f494
11 changed files with 3243 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,112 @@
+# NAS Media Player
+
+轻量级NAS媒体播放器，专为多架构Linux系统设计（armhf/arm64/x86_64），完美兼容嵌入式设备（如hi3798mv100）和常规Ubuntu/Debian发行版，提供视频文件浏览、播放、上传、目录管理、私密目录保护等核心功能，开箱即用。
+
+## 🌟 功能特性
+- **多架构适配**：自动识别armv7l(armhf)、aarch64(arm64)、x86_64架构，无需手动选择二进制文件
+- **核心功能**：视频文件浏览/播放、大文件上传、目录创建/删除、私密目录密码保护
+- **轻量化部署**：单脚本一键安装，自动配置systemd服务（开机自启）
+- **日志可视化**：运行日志固定存储在程序目录，便于问题排查
+- **兼容性强**：适配嵌入式设备（如hi3798mv100）和普通Linux服务器
+
+## 🚀 快速开始
+
+## 一、海纳思系统安装方法  
+> [!TIP]
+>  海纳思系统，直接如下安装即可  
+> apt update && apt install -y nas-media-player  
+>  忽略下面一切
+
+## 二、其他ubuntu/debian系统  
+> [!TIP]
+>  非海纳思系统，则推荐用以下命令快速运行容器，无需手动配置：
+
+```
+docker run -d \
+  --name nas-media-player \
+  -p 8800:8800 \
+  -v ~/nas-media:/mnt \
+  --restart always \
+  slitazcn/nas-media-player:latest
+```
+
+## 三、进阶者脚本安装   
+### 1. 环境要求
+- 系统：Linux（Ubuntu/Debian/嵌入式Linux，支持systemd最佳）
+- 权限：需root权限（sudo）
+- 网络：克隆仓库需网络连通（部署后无网络也可使用）
+
+### 2. 克隆仓库
+```bash
+git clone https://github.com/teasiu/nas-media-player.git
+cd nas-media-player
+```
+
+### 3. 一键安装 & 启动
+安装脚本会自动完成「架构检测→文件部署→服务配置→启动运行」全流程：
+```bash
+sudo ./install.sh install
+```
+
+### 4. 访问服务
+安装完成后，在浏览器中访问以下地址即可使用：
+```plaintext
+http://[你的设备IP]:8800
+```
+示例：`http://192.168.101.141:8800`
+
+## ⚙️ 常用命令
+| 功能         | 执行命令                                          | 说明                                    |
+|--------------|---------------------------------------------------|-----------------------------------------|
+| 启动服务     | `sudo ./install.sh start`                         | 启动NAS Media Player服务                |
+| 停止服务     | `sudo ./install.sh stop`                          | 停止运行中的服务                        |
+| 重启服务     | `sudo ./install.sh restart`                       | 重启服务（配置修改后生效）              |
+| 查看状态     | `sudo ./install.sh status`                        | 查看服务运行状态、端口监听、目录状态    |
+| 查看日志     | `tail -f /opt/nas-media-player/nas-media-player.log` | 实时查看运行日志                        |
+| 卸载服务     | `sudo ./install.sh uninstall`                     | 卸载程序（保留/mnt媒体目录文件）        |
+| 查看帮助     | `sudo ./install.sh help`                          | 查看所有可用命令                        |
+
+## 🛠️ 配置说明
+核心配置可在`install.sh`脚本头部修改，无需改动代码：
+| 配置项       | 默认值                  | 说明                                  |
+|--------------|-------------------------|---------------------------------------|
+| `APP_DIR`    | `/opt/nas-media-player` | 程序安装目录                          |
+| `PORT`       | `8800`                  | 服务监听端口                          |
+| `VIDEO_DIR`  | `/mnt`                  | 媒体文件存储根目录                    |
+| `LOG_FILE`   | `${APP_DIR}/nas-media-player.log` | 运行日志文件路径               |
+
+## ❓ 常见问题
+### Q1：安装后端口8800未监听？
+- 嵌入式设备启动可能有延迟，等待1分钟后重试；
+- 执行`sudo ./install.sh status`查看服务状态；
+- 查看日志排查：`tail -f /opt/nas-media-player/nas-media-player.log`。
+
+### Q2：上传文件失败/目录创建报错？
+- 检查`/mnt`目录权限：`sudo chmod 777 /mnt`；
+- 确认磁盘空间充足，大文件上传建议使用有线网络。
+
+### Q3：不支持的架构报错？
+- 仅支持armhf/arm64/x86_64架构，执行`uname -m`查看系统架构。
+
+### Q4：卸载后重新安装失败？
+- 先执行`sudo ./install.sh uninstall`清理残留，再重新安装。
+
+## 📂 目录结构
+```plaintext
+nas-media-player/
+├── install.sh          # 一键安装/管理脚本
+├── nas-media-player.py # 主程序源码
+├── index.html          # 前端页面
+├── zhinan.html         # 帮助页面
+├── releases/           # 多架构二进制文件目录
+│   ├── nas-media-player-armhf
+│   ├── nas-media-player-arm64
+│   └── nas-media-player-x86_64
+└── README.md           # 说明文档
+```
+
+## 📄 许可证
+本项目采用 MIT 许可证 - 详见 `LICENSE` 文件。
+
+## 🤝 贡献
+欢迎提交Issue反馈问题，或PR优化功能，提交前请确保脚本在多架构环境下测试通过。