{"id":29099271,"url":"https://github.com/openlistteam/openlist-desktop","last_synced_at":"2026-02-10T08:04:29.821Z","repository":{"id":301311288,"uuid":"1008193415","full_name":"OpenListTeam/openlist-desktop","owner":"OpenListTeam","description":"A desktop application for OpenList","archived":false,"fork":false,"pushed_at":"2025-06-26T08:13:45.000Z","size":2176,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T08:24:14.595Z","etag":null,"topics":["openlist","tauri","vuejs"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenListTeam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-25T07:07:36.000Z","updated_at":"2025-06-26T08:13:49.000Z","dependencies_parsed_at":"2025-06-26T08:35:04.624Z","dependency_job_id":null,"html_url":"https://github.com/OpenListTeam/openlist-desktop","commit_stats":null,"previous_names":["openlistteam/openlist-desktop"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/OpenListTeam/openlist-desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenListTeam%2Fopenlist-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenListTeam%2Fopenlist-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenListTeam%2Fopenlist-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenListTeam%2Fopenlist-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenListTeam","download_url":"https://codeload.github.com/OpenListTeam/openlist-desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenListTeam%2Fopenlist-desktop/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262457931,"owners_count":23314288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openlist","tauri","vuejs"],"created_at":"2025-06-28T16:02:03.020Z","updated_at":"2026-02-10T08:04:29.780Z","avatar_url":"https://github.com/OpenListTeam.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenList Desktop\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./app-icon.png\" alt=\"OpenList Desktop\" width=\"128\" height=\"128\" /\u003e\n  \n  **跨平台的 OpenList 桌面应用程序，集成云存储功能**\n\n  [![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](./LICENSE)\n  [![Vue](https://img.shields.io/badge/Vue-3.5.17-green.svg)](https://vuejs.org/)\n  [![Tauri](https://img.shields.io/badge/Tauri-2.6.0-orange.svg)](https://tauri.app/)\n  [![Rust](https://img.shields.io/badge/Rust-2024-red.svg)](https://www.rust-lang.org/)\n  \n  [English](./README_en.md) | [中文](./README.md)\n\u003c/div\u003e\n\n## WIP\n\n该项目仍在开发中，预计很快发布1.0版本。\n\n## 🔍 概述\n\nOpenList Desktop 是一个功能强大的跨平台桌面应用程序，为管理 OpenList 服务和通过 Rclone 集成云存储提供用户友好的界面。使用现代 Web 技术和 Rust 构建，提供无缝的文件管理、云存储挂载和服务监控功能。\n\n该应用程序是一个全面的解决方案，用于：\n\n- 管理 OpenList 文件管理服务\n- 挂载和管理云存储（WebDAV）\n- 监控服务健康和性能\n- 提供系统托盘集成以进行后台操作\n\n## ✨ 功能特性\n\n### 🚀 核心功能\n\n- **OpenList 服务管理**：启动、停止和监控 OpenList 核心服务\n- **云存储集成**：通过 Rclone 挂载\n- **实时监控**：跟踪服务状态、运行时间和性能指标\n- **进程管理**：具有自动重启功能的高级进程控制\n- **系统托盘**：带系统托盘通知的后台操作\n\n### ⚙️ 管理功能\n\n- **服务控制**：启动/停止/重启 OpenList 和 Rclone 服务\n- **配置管理**：所有服务的基于 GUI 的配置\n- **日志监控**：实时日志查看和管理\n- **更新管理**：自动更新检查和安装\n- **自动启动**：配置应用程序与系统一起启动\n\n### 🎨 用户体验\n\n- **现代 UI**：使用 Vue.js 构建的简洁、直观界面\n- **多语言**：支持英语和中文\n- **响应式设计**：针对各种屏幕尺寸优化\n- **键盘快捷键**：使用键盘快捷键高效导航\n- **教程系统**：为新用户提供内置教程\n\n## 📸 应用截图\n\n### 主页仪表板\n\n![主页仪表板](./screenshot/homepage.png)\n\n主仪表板提供您的 OpenList Desktop 环境的全面概览：\n\n- 服务状态监控\n- 常见任务的快速操作按钮\n- 版本管理和更新通知\n- 服务管理控制\n\n### 挂载管理\n\n![挂载管理](./screenshot/mountpage.png)\n\n轻松管理您的云存储连接：\n\n- 添加和配置存储远程\n- 挂载/卸载云存储\n- 监控挂载状态和统计信息\n- 配置自动挂载选项\n\n### 设置配置\n\n![设置](./screenshot/settingpage.png)\n\n全面的设置管理：\n\n- OpenList 服务配置\n- 启动和自动化偏好设置\n- 主题和语言选择\n\n### 日志监控\n\n![日志监控](./screenshot/logpage.png)\n\n跟踪系统操作：\n\n- 实时日志流\n- 按来源和级别过滤日志\n- 导出和清除日志功能\n\n### 更新管理\n\n![更新管理](./screenshot/update.png)\n\n保持最新版本：\n\n- 检查 OpenList 和 Rclone 更新\n- 下载和安装更新\n- 版本历史和更新日志\n- 自动更新计划\n\n## 📦 安装\n\n### 系统要求\n\n- **操作系统**：Windows 10+、macOS 10.15+ 或 Linux（Ubuntu 18.04+）\n\n### 下载选项\n\n#### 1. GitHub 发布版（推荐）\n\n从 [GitHub Releases](https://github.com/OpenListTeam/openlist-desktop/releases) 下载最新版本：\n\n- **Windows**：`OpenList-Desktop_x.x.x_x64_en-US.msi`\n- **macOS**：`OpenList-Desktop_x.x.x_x64.dmg`\n- **Linux**：`OpenList-Desktop_x.x.x_amd64.AppImage`\n\n#### 2. 从源码构建\n\n```bash\n# 克隆仓库\ngit clone https://github.com/OpenListTeam/openlist-desktop.git\ncd openlist-desktop\n\n# 安装依赖\nnpm install\n\n# 准备开发环境\nnpm run prepare-dev\n\n# 构建应用程序\nnpm run build\nnpm run tauri build\n```\n\n### 安装步骤\n\n#### Windows\n\n1. 下载 `.exe` 安装程序\n2. 以管理员身份运行安装程序\n3. 按照安装向导进行操作\n4. 从开始菜单或桌面快捷方式启动\n\n#### macOS\n\n1. 下载 `.dmg` 文件\n2. 打开 DMG 并将 OpenList Desktop 拖到应用程序文件夹\n3. 右键单击并选择\"打开\"（仅首次）\n4. 在提示时授予必要权限\n\n#### Linux\n\n1. 下载 `.deb` 或 `.rpm` 包\n2. 使用包管理器安装：\n   ```bash\n   sudo dpkg -i OpenList-Desktop_x.x.x_amd64.deb\n   # 或者\n   sudo rpm -i OpenList-Desktop_x.x.x_amd64.rpm\n   ```\n\n## 🚀 使用说明\n\n### 首次启动\n\n1. **初始设置**：首次启动时，应用程序将指导您完成初始配置\n2. **服务安装**：在提示时安装 OpenList 服务\n3. **存储配置**：配置您的第一个云存储连接\n4. **教程**：完成交互式教程以学习关键功能\n\n### 基本操作\n\n#### 启动服务\n\n```bash\n仪表板 → 服务管理 → 启动 OpenList 服务\n仪表板 → 快速操作 → 启动 Rclone 后端\n```\n\n#### 添加云存储\n\n1. 导航到 **挂载** 选项卡\n2. 点击 **添加远程** 按钮\n3. 配置存储设置：\n   - **名称**：存储的唯一标识符\n   - **类型**：存储提供商（WebDAV）\n   - **URL**：存储端点 URL\n   - **凭据**：用户名和密码\n   - **挂载点**：本地目录路径\n4. 点击 **保存** 和 **挂载**\n\n#### 监控操作\n\n- **服务状态**：检查仪表板上的服务健康指示器\n- **日志**：使用日志选项卡监控系统操作\n- **性能**：在仪表板上查看运行时间和响应指标\n\n### 高级功能\n\n#### 自动挂载配置\n\n```javascript\n// 配置存储在启动时自动挂载\n{\n  \"autoMount\": true,\n  \"extraFlags\": [\"--vfs-cache-mode\", \"full\"],\n  \"mountPoint\": \"/mnt/cloudstorage\"\n}\n```\n\n#### 自定义 Rclone 标志\n\n添加自定义 Rclone 标志以获得最佳性能：\n\n- `--vfs-cache-mode full`：启用完整 VFS 缓存\n- `--buffer-size 256M`：增加缓冲区大小\n- `--transfers 10`：并发传输限制\n\n#### 系统托盘操作\n\n- **右键单击托盘图标** 进行快速操作\n- **双击** 显示/隐藏主窗口\n\n## ⚙️ 配置\n\n### 应用程序设置\n\n#### OpenList 服务配置\n\n```json\n{\n  \"openlist\": {\n    \"port\": 5244,\n    \"api_token\": \"your-secure-token\",\n    \"auto_launch\": true,\n    \"ssl_enabled\": false\n  }\n}\n```\n\n#### Rclone 配置\n\n```json\n{\n  \"rclone\": {\n    \"config\": {\n      \"mycloud\": {\n        \"type\": \"webdav\",\n        \"url\": \"https://cloud.example.com/dav\",\n        \"user\": \"username\",\n        \"pass\": \"encrypted-password\",\n        \"mountPoint\": \"C:/CloudDrive\",\n        \"autoMount\": true,\n        \"extraFlags\": [\"--vfs-cache-mode\", \"full\"]\n      }\n    },\n  }\n}\n```\n\n#### 应用程序偏好设置\n\n```json\n{\n  \"app\": {\n    \"theme\": \"auto\",\n    \"auto_update_enabled\": true,\n    \"monitor_interval\": 30000\n  }\n}\n```\n\n### 环境变量\n\n- `OPENLIST_API_TOKEN`：覆盖默认 API 令牌\n- `OPENLIST_PORT`：覆盖默认端口（5244）\n- `RCLONE_CONFIG_DIR`：自定义 Rclone 配置目录\n- `LOG_LEVEL`：设置日志级别（debug、info、warn、error）\n\n## 🔧 开发\n\n### 开发环境设置\n\n#### 先决条件\n\n- **Node.js**：v22+ 和 yarn\n- **Rust**：最新稳定版本\n- **Git**：版本控制\n\n#### 设置步骤\n\n```bash\n# 克隆仓库\ngit clone https://github.com/OpenListTeam/openlist-desktop.git\ncd openlist-desktop\n\n# 安装 Node.js 依赖\nyarn install\n\n# 安装 Rust 依赖\ncd src-tauri\ncargo fetch\n\n# 准备开发环境\ncd ..\nyarn run prebuild:dev\n\n# 启动开发服务器\nyarn run dev\n```\n\n#### 开发命令\n\n```bash\n# 启动带热重载的开发服务器\nyarn run dev\n\n# 启动不带文件监视的开发\nyarn run nowatch\n\n# 运行代码检查\nyarn run lint\n\n# 修复代码检查问题\nyarn run lint:fix\n\n# 类型检查\nyarn run build --dry-run\n```\n\n#### 提交PR\n\n```bash\ngit add .\nyarn cz\n```\n\n## 🤝 贡献\n\n我们欢迎社区贡献！\n\n## 📄 许可证\n\n本项目在 **GNU 通用公共许可证 v3.0** 下许可 - 详情请参见 [LICENSE](./LICENSE) 文件。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e由 OpenList 团队用 ❤️ 制作\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/OpenListTeam/openlist-desktop\"\u003eGitHub\u003c/a\u003e •\n    \u003ca href=\"https://openlist.team\"\u003e网站\u003c/a\u003e •\n    \u003ca href=\"https://t.me/OpenListTeam\"\u003eTelegram\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenlistteam%2Fopenlist-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenlistteam%2Fopenlist-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenlistteam%2Fopenlist-desktop/lists"}