1panel第三方应用库1panel-appstore

巨二兔

安装/使用方式

将 local_appstore_sync_helper.sh 放到 1panel 计划任务中,定时执行即可自动同步本仓库应用,默认无需修改脚本任何参数

特性

可一键更新同步1Panel官网的应用商店应用到本地环境

支持将任意第三方仓库的应用同步到1Panel的本地应用商店

支持github，gitlab，gitee等公开仓库、私有仓库

支持将多个分散的仓库应用同步到1Panel的本地应用商店

支持自定义拉取的分支、克隆深度、访问代/里等，方便灵活

同步脚本源码完全开源，可自行修改、扩展，可放心使用

使用场景

1Panel官方应用商店的应用更新慢，想要快速更新到本地进行使用

1Panel官方应用有BUG，或者版本太低，想要自己修改后使用

1Panel官方应用商店没有自己想要的应用，想要自己添加应用

由于某些原因没法上架到1Panel官方应用商店，定制自己的专属应用

用于快速调试开发1Panel应用，方便本地开发调试

想要将多个分散的仓库应用同步到1Panel的本地应用商店

效果演示

将1Panel appstore里最近更的应用一键同步到本地应用商店

使用教程

1. 使用1Panel创建计划任务

按上图方式创建计划任务。

然后将 local_appstore_sync_helper.sh 内容复制到脚本内容框中。

按需修改脚本中的配置项，具体的配置项说明见下文。

2. 执行同步脚本

点击执行按钮，可即可开始同步。

3. 查看同步脚本的执行情况

点击任务名称或【报告】按钮即可查看同步脚本的执行日志。

注意：目前1Panel的计划任务执行失败的话查看不了任何日志，这个时候去【主机】>【文件】然后进入：

/opt/1panel_hepler/logs

目录下查看同步脚本的执行日志即可。

4. 查看同步成功的本地应用

进入【应用商店】点击右上角的【更新应用列表】即可查看同步到的本地应用。

配置项详解

local_appstore_sync_helper.sh 里包含了一些配置项，可以根据自己的需求进行修改。

1. #!/bin/bash
   
2. # 直接执行或复制此脚本到 1Panel->计划任务中定时执行即可
   
3. 
   
4. # 1panel本地app的目录（如果不是默认安装，需修改该目录）
   
5. app_local_dir="/opt/1panel/resource/apps/local"
   
6. 
   
7. # AppStore的git仓库地址（必选）
   
8. #git_repo_url="https://github.com/okxlin/appstore"
   
9. git_repo_url="https://gitee.com/svip520/1panel-appstore"
   
10. 
    
11. # 访问git仓库的access token，访问私有仓库时用，优先级高于账密（可选）
    
12. # 建议使用access token，降低账密泄露的风险
    
13. git_access_token=""
    
14. 
    
15. # 访问git仓库的用户名，访问私有仓库时用（可选）
    
16. git_username=""
    
17. # 访问git仓库的密码，访问私有仓库时用（可选）
    
18. git_password=""
    
19. 
    
20. # 指定克隆的分支（可选）
    
21. git_branch=""
    
22. # 指定克隆的深度（可选）
    
23. git_depth=1
    
24. 
    
25. # 拉取远程仓库前是否清空本地app目录（可选）
    
26. clean_local_app=true
    
27. # 拉取远程仓库前是否清空远程app缓存（可选）
    
28. clean_remote_app_cache=false
    
29. 
    
30. # 设置克隆或拉取远程仓库时使用的代/里（可选）
    
31. proxyUrl=""
    
32. # 设置示例：
    
33. # proxyUrl="http://127.0.0.1:7890"
    
34. # proxyUrl="socks5://127.0.0.1:7890"
    
35. # proxyUrl="socks5://user:password@host:port"
    
36. 
    
37. # 将远程app store工程克隆到本地的工作目录
    
38. work_dir="/opt/1panel_hepler"
    
39. 
    
40. set -e
    
41. 
    
42. mkdir -p "$work_dir/logs"
    
43. log_file="$work_dir/logs/local_appstore_sync_helper_$(date +"%Y-%m-%d").log"
    
44. logs() {
    
45.   local message="$1"
    
46. 
    
47.   if [ -n "$log_file" ]; then
    
48.     mkdir -p "$(dirname "$log_file")"
    
49.     if [ $? -eq 0 ]; then
    
50.       echo -e "[$(date +"%Y-%m-%d %H:%M:%S")] $message"
    
51.       echo "[$(date +"%Y-%m-%d %H:%M:%S")] $message" >>"$log_file"
    
52.       return
    
53.     fi
    
54.   fi
    
55. 
    
56.   echo -e "$message"
    
57. }
    
58. 
    
59. # 函数: url_encode
    
60. # 参数:
    
61. #   - url: 需要进行编码的字符串
    
62. # 返回值:
    
63. #   经过URL编码后的字符串
    
64. function url_encode() {
    
65.   local string=$1
    
66.   local length="${#string}"
    
67.   local url_encoded_string=""
    
68.   local c
    
69. 
    
70.   for ((i = 0; i < length; i++)); do
    
71.     c=${string:i:1}
    
72.     case "$c" in
    
73.     [a-zA-Z0-9.~_-]) url_encoded_string+=$c ;;
    
74.     *) url_encoded_string+=$(printf '%%%02X' "'$c") ;;
    
75.     esac
    
76.   done
    
77. 
    
78.   echo "$url_encoded_string"
    
79. }
    
80. 
    
81. # 定义函数，接收一个URL参数和可选的替换字符串参数
    
82. replace_protocol() {
    
83.   local url=$1
    
84.   local replacement=$2
    
85. 
    
86.   # 如果没有提供替换字符串，则删除"http://"或"https://"
    
87.   if [[ -z $replacement ]]; then
    
88.     local new_url=$(echo $url | sed "s/http:\/\///" | sed "s/https:\/\///")
    
89.   else
    
90.     local new_url=$(echo $url | sed "s/http:\/\//${replacement}/" | sed "s/https:\/\//${replacement}/")
    
91.   fi
    
92. 
    
93.   # 输出替换后的URL
    
94.   echo $new_url
    
95. }
    
96. 
    
97. # 函数: clone_git_repo
    
98. # 参数:
    
99. #   - url: Git仓库URL
    
100. #   - username: 账号（可选）
     
101. #   - password: 密码（可选）
     
102. #   - access_token: 访问令牌（可选）
     
103. #   - branch: 克隆分支（可选）
     
104. #   - depth: 克隆深度（可选，默认为0，即克隆整个仓库）
     
105. function clone_git_repo() {
     
106.   local url=$1
     
107.   local username=$2
     
108.   local password=$3
     
109.   local access_token=$4
     
110.   local branch=$5
     
111.   local depth=$6
     
112. 
     
113.   branch=${branch:+--branch $branch}
     
114.   depth=${depth:+--depth $depth}
     
115. 
     
116.   echo "branch: $branch, depth: $depth"
     
117. 
     
118.   if [[ -n $access_token ]]; then
     
119.     echo "use access_token to clone"
     
120.     local fix_url=$(replace_protocol "$url")
     
121.     git clone "https://oauth2:$access_token@$fix_url" $branch $depth
     
122.   elif [[ -n $username && -n $password ]]; then
     
123.     local encoded_username=$(url_encode "$username")
     
124.     local encoded_password=$(url_encode "$password")
     
125.     local fix_url=$(replace_protocol "$url")
     
126. 
     
127.     # echo "use username and password to clone, encoded_username: $encoded_username, encoded_password: $encoded_password, fix_url: $fix_url"
     
128.     echo "use username and password to clone"
     
129. 
     
130.     git clone "https://$encoded_username:$encoded_password@$fix_url" $branch $depth
     
131.   else
     
132.     echo "use default clone"
     
133.     git clone "$url" $branch $depth
     
134.   fi
     
135. }
     
136. 
     
137. # 取消代/里
     
138. function proxy_off() {
     
139.   unset http_proxy
     
140.   unset https_proxy
     
141.   unset ALL_PROXY
     
142.   unset no_proxy
     
143.   logs "Proxy Off"
     
144. }
     
145. 
     
146. # 开启代/里
     
147. function proxy_on() {
     
148.   proxy_url="http://127.0.0.1:7890"
     
149.   match_str="://"
     
150. 
     
151.   if [ -n "$1" ]; then
     
152.     if [[ $1 =~ $match_str ]]; then
     
153.       proxy_url=$1
     
154.     else
     
155.       logs "Incorrect proxy_url, use defualt proxy_url"
     
156.       return
     
157.     fi
     
158.   fi
     
159. 
     
160.   export http_proxy=$proxy_url
     
161.   export https_proxy=$proxy_url
     
162.   export ALL_PROXY=$proxy_url
     
163.   export no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com"
     
164.   logs "Proxy On $proxy_url"
     
165. }
     
166. 
     
167. function scriptInfo() {
     
168.   echo ""
     
169.   logs "##################################################################"
     
170.   logs "#    Name: local appstore sync helper for 1Panel                 #"
     
171.   logs "# Version: v1.0.0                                                #"
     
172.   logs "#  Author: nameless                                              #"
     
173.   logs "#  Github: https://gitee.com/svip520/1panel-appstore             #"
     
174.   logs "##################################################################"
     
175.   echo ""
     
176. }
     
177. 
     
178. function main() {
     
179.   scriptInfo
     
180. 
     
181.   if [ ! -d "$app_local_dir" ]; then
     
182.     logs "未检测到1panel的app目录，请检查1panel是否安装正确，或修改脚本中的app_local_dir变量"
     
183.     exit 1
     
184.   fi
     
185. 
     
186.   # 检查地址结尾是否包含.git，如果不包含则自动补全
     
187.   if [[ "$git_repo_url" != *".git" ]]; then
     
188.     git_repo_url="${git_repo_url}.git"
     
189.   fi
     
190. 
     
191.   local repo_username=""
     
192.   local repo_projectname=""
     
193. 
     
194.   # 使用正则表达式匹配仓库地址中的用户名和项目名
     
195.   if [[ $git_repo_url =~ .*\/(.*)\/(.*)\.git ]]; then
     
196.     repo_username=${BASH_REMATCH[1]}
     
197.     repo_projectname=${BASH_REMATCH[2]}
     
198.     # logs "用户名: $repo_username"
     
199.     # logs "项目名: $repo_projectname"
     
200.   fi
     
201. 
     
202.   if [ -z "$repo_username" ] || [ -z "$repo_projectname" ]; then
     
203.     logs "无法提取用户名和项目名，请检查git_repo_url变量提供的地址是否正确"
     
204.     exit 1
     
205.   fi
     
206. 
     
207.   mkdir -p "$work_dir/temp"
     
208. 
     
209.   local repo_user_dir="$work_dir/temp/$repo_username"
     
210.   local repo_dir="$repo_user_dir/$repo_projectname"
     
211. 
     
212.   # 根据clean_remote_app_cache变量的值决定是否清空远程app的缓存数据
     
213.   if [ "$clean_remote_app_cache" = true ] && [ -d "$repo_dir" ]; then
     
214.     rm -rf "$repo_dir"
     
215.     logs "已清空远程app的缓存数据"
     
216.   fi
     
217. 
     
218.   # 根据proxyUrl变量的值决定是否开启代/里
     
219.   if [ -n "$proxyUrl" ]; then
     
220.     proxy_on "$proxyUrl"
     
221.   fi
     
222. 
     
223.   # clone或拉取远程仓库最/新代码
     
224.   logs "准备获取远程仓库最/新代码：$git_repo_url"
     
225.   if [ -d "$repo_dir" ]; then
     
226.     logs "执行git pull操作"
     
227.     cd "$repo_dir"
     
228. 
     
229.     # 强行拉取最/新代码
     
230.     git pull --force 2>>"$log_file"
     
231.   else
     
232.     logs "执行git clone操作"
     
233.     mkdir -p "$repo_user_dir"
     
234.     cd "$repo_user_dir"
     
235. 
     
236.     clone_git_repo "$git_repo_url" "$git_username" "$git_password" "$git_access_token" "$git_branch" "$git_depth" 2>>"$log_file"
     
237.   fi
     
238. 
     
239.   logs "远程仓库最/新代码获取完成"
     
240. 
     
241.   if [ ! -d "$repo_dir/apps" ]; then
     
242.     logs "未检测到apps目录，请检查远程仓库是否正确"
     
243.     exit 1
     
244.   fi
     
245. 
     
246.   # 根据clean_local_app变量的值决定是否清空本地app目录
     
247.   if [ "$clean_local_app" = true ]; then
     
248.     rm -rf "$app_local_dir"/*
     
249.     logs "已清空本地原有的app"
     
250.   fi
     
251. 
     
252.   # 将远程仓库的apps目录下的所有app复制到本地app_local_dir目录下
     
253.   cd "$repo_dir"
     
254.   cp -rf apps/* "$app_local_dir"
     
255. 
     
256.   pwd
     
257.   ls -lah
     
258.   du -sh
     
259. 
     
260.   # 根据clean_remote_app_cache变量的值决定是否清空远程app的缓存数据
     
261.   if [ "$clean_remote_app_cache" = true ]; then
     
262.     rm -rf "$repo_dir"
     
263.   fi
     
264. 
     
265.   if [ -n "$proxyUrl" ]; then
     
266.     proxy_off
     
267.   fi
     
268. 
     
269.   logs "1panel本地app同步成功，enjoy it!"
     
270. }
     
271. 
     
272. main "$@"
     

复制代码

各个配置项的具体说明如下：

配置项	必选	使用说明
app_local_dir	是	1Panel本地app的目录（如果不是默认安装，需修改该目录）
git_repo_url	是	AppStore的git仓库地址，直接复制链接地址即可，脚本会自动补充链接需要的字段
git_access_token	否	访问git仓库的access token，访问私有仓库时用，优先级高于账密
git_username	否	访问git仓库的用户名，访问私有仓库时用
git_password	否	访问git仓库的密码，访问私有仓库时用；脚本已增加了对特殊字符的支持
git_branch	否	指定克隆的分支，不指定则使用仓库的默认分支
git_depth	否	指定克隆的深度，层级越多克隆越慢，建议默认即可
clean_local_app	否	拉取远程仓库前是否清空本地app目录，可以把不需要旧应用清除掉，保持跟线上的一致 如果要同步多个仓库的应用，则必须设定为flase，否则只会看到最/后一个的同步结果
clean_remote_app_cache	否	拉取远程仓库前是否清空远程app缓存，相当于重新clone远程app仓库
proxyUrl	否	设置克隆或拉取远程仓库时使用的代/里，一般来说国内克隆GitHub仓的时候用得到
work_dir	是	将远程app store工程克隆到本地的工作目录，用于临时存放克隆下来的文件和脚本工作日志

1Panel应用源

应用源地址	说明
https://github.com/1Panel-dev/appstore	1Panel官方应用商店
https://github.com/qwenode/1panel-appstore	基于1Panel的又一个第三方应用商店
https://github.com/okxlin/appstore	基于1Panel的第三方应用商店
https://gitee.com/svip520/1panel-appstore	无名的1Panel应用商店

直接将上面的应用源地址粘贴到git_repo_url变量里即可使用

PS: 如需集成多个应用源到自己的系统里，只需新建多个定时任务，然后设定不同的git_repo_url变量即可，另外不同地址的应用源更新频率不一样，建议根据自己的需求来设定不同任务的执行周期。

exlse@foxmail.c

6666666