一键扩展1Panel生态：第三方应用商店库接入指南

一、为什么要添加第三方库？

作为现代化的服务器管理面板，1Panel官方应用商店虽然提供了丰富的应用，但在实际使用中我们可能会遇到：

1. 需要特定版本的应用（如旧版MySQL/Redis）
2. 官方商店未收录的实用工具（如WebP服务器、特殊中间件）
3. 本地化定制的开发环境需求
4. 网络因素导致的官方商店访问受限

二、准备事项

• 已安装1Panel面板（建议≥v2.0.0）
• 服务器需开放GitHub访问（或配置镜像源）
• 确认面板安装路径为/opt/1panel（官方默认路径）

三、详细操作步骤

3.1 添加第三方仓库

通过计划任务实现自动化同步：

#!/bin/bash
REPO_URL="https://github.com/okxlin/appstore.git"
TARGET_DIR="/opt/1panel/third_party/appstore_okxlin"

# 清理旧仓库
[ -d "$TARGET_DIR" ] && rm -rf $TARGET_DIR

# 克隆新仓库
git clone --depth=1 $REPO_URL $TARGET_DIR

# 刷新应用列表
curl -X POST http://localhost:端口号/api/v1/apps/refresh

注：端口号可在面板设置-参数设置中查看

3.2 配置定时同步（推荐）

1. 进入【计划任务】→【新建任务】
2. 设置执行周期：建议每周同步一次
3. 脚本内容：

#!/bin/bash
cd /opt/1panel/third_party/appstore_okxlin && git pull origin main
systemctl restart 1panel.service

3.3 应用加载验证

1. 打开应用商店页面
2. 查看底部是否出现「第三方应用」分类
3. 搜索特色应用测试（如TinyMediaManager、JDownloader等）

四、注意事项

1. 安全提醒

   • 仅添加可信第三方源（建议审查仓库内容）
   • 生产环境建议测试后部署
   • 关注仓库的Star数量和更新频率

2. 常见问题排查

   # 查看仓库同步日志
   journalctl -u 1panel.service -n 100
   
   # 手动刷新应用列表
   1panel-cli apps refresh
   

3. 进阶技巧

   • 私有仓库支持：在Git Clone命令中添加SSH Key认证
   • 多仓库共存：通过不同目录管理多个第三方源
   • 本地化缓存：配置Nginx反向代理提升同步速度

五、优质第三方仓库推荐

1. okxlin/appstore（持续维护的中文应用库）
2. Community-Apps（社区维护合集）
3. DevOps-Toolkits（运维增强工具集）

六、结语

通过扩展第三方应用仓库，1Panel的生态能力将得到显著提升。建议开发者在享受丰富应用的同时：

• 定期检查仓库更新状态
• 参与社区应用适配（官方提供开发文档）
• 关注1Panel的版本兼容性提示

遇到技术问题可前往1Panel社区论坛交流，欢迎分享您的应用适配经验！