梅家部落

large picture of the cover

1Panel 本地应用创建技巧及第三方应用库举例

1 简介

这是一个关于 1Panel v1.3 版本使用本地应用的教程。

省流总结：只要将符合规则的应用放到/opt/1panel/resource/apps/local文件夹下

1.1 如何创建适合自己的本地应用


1panel app help

  • 技巧 3：一个应用创建例子，即会在当前目录生成一个应用模板文件夹


1panel app init -k debian -v 11.7

创建一个应用初始模板，应用 key 关键词(文件夹名)为: debian，版本号为: 11.7

2 第三方应用库

这边毛遂自荐一个本地应用库，一般都是我自己用到的，应用暂时还不是很多。

默认 1Panel 安装在 /opt/ 路径下，如果不是可按需修改。

关于大陆电磁环境复杂，github 网络连接可能有问题，可以自行搜寻解决方式，如 ghproxy 等。

2.1 使用 git 命令获取应用

  • 克隆名为 localApps 的分支的仓库到 /opt/1panel/resource/apps/local/appstore-localApps 目录下


git clone -b localApps https://github.com/okxlin/appstore /opt/1panel/resource/apps/local/appstore-localApps

  • 将 /opt/1panel/resource/apps/local/appstore-localApps/apps 目录下的所有文件复制到 /opt/1panel/resource/apps/local/ 目录下


cp -rf /opt/1panel/resource/apps/local/appstore-localApps/apps/* /opt/1panel/resource/apps/local/

  • 删除 /opt/1panel/resource/apps/local/appstore-localApps 目录及其内容


rm -r /opt/1panel/resource/apps/local/appstore-localApps

  • 然后应用商店刷新本地应用即可。

将其转换为 1panel 计划任务形式则是，在计划任务框里添加以下命令


git clone -b localApps https://github.com/okxlin/appstore /opt/1panel/resource/apps/local/appstore-localApps



cp -rf /opt/1panel/resource/apps/local/appstore-localApps/apps/* /opt/1panel/resource/apps/local/



rm -r /opt/1panel/resource/apps/local/appstore-localApps

2.2 使用压缩包方式获取应用

  • 下载 localApps.zip 文件到目标目录


wget -P /opt/1panel/resource/apps/local https://github.com/okxlin/appstore/archive/refs/heads/localApps.zip

  • 解压缩localApps.zip文件到目标目录


unzip -o -d /opt/1panel/resource/apps/local/ /opt/1panel/resource/apps/local/localApps.zip

  • 复制appstore-localApps/apps目录下的所有内容到目标目录


cp -rf /opt/1panel/resource/apps/local/appstore-localApps/apps/* /opt/1panel/resource/apps/local/

  • 删除appstore-localApps目录及其内容


rm -r /opt/1panel/resource/apps/local/appstore-localApps

  • 删除localApps.zip文件


rm /opt/1panel/resource/apps/local/localApps.zip

  • 然后应用商店刷新本地应用即可。

将其转换为1panel计划任务形式则是，在计划任务框里添加以下命令


wget -P /opt/1panel/resource/apps/local https://github.com/okxlin/appstore/archive/refs/heads/localApps.zip



unzip -o -d /opt/1panel/resource/apps/local/ /opt/1panel/resource/apps/local/localApps.zip



cp -rf /opt/1panel/resource/apps/local/appstore-localApps/apps/* /opt/1panel/resource/apps/local/



rm -r /opt/1panel/resource/apps/local/appstore-localApps



rm /opt/1panel/resource/apps/local/localApps.zip

2.3 备注

未显示在本地应用列表里的，但是存在实际文件夹，表示是测试应用

3、其他第三方应用商店

仓库地址：
Gitea:

https://git.lifebus.top/Ms-Studio/appstore-1panel

https://gitea.com/QYG2297248353/appstore-1panel

GitHub

https://github.com/QYG2297248353/appstore-1panel

Docker 应用商店 - 1Panel 版本 - 人生足迹 · 博客 133

本项目由 新疆萌森软件开发工作室 提供技术支持，我们致力于为 1Panel 应用商店用户提供更多的应用程序。

1Pane 导入应用商店

温馨提示： 当您已安装其他第三方库时并且存在应用冲突，安装过程中会主动删除冲突的第三方库应用，如果您不同意，请不要执行脚本。

我们建议您在安装之前备份您的数据，或手动安装。

如果您不使用 curl 命令，可以使用 wget 命令代替。

将 curl -sSL 替换为 wget -qO- 即可。

脚本执行成功后，会自动将应用添加到 1Panel 应用商店中，在应用商店页执行 更新应用列表 即可看到新应用。

自动化安装

一键式安装，无需手动操作，自动完成 1Panel应用 上架应用商店。

每三小时自动更新一次应用列表。

curl -sSL https://install.lifebus.top/auto_install.sh | bash

卸载自动化脚本 (不会卸载应用)

curl -sSL https://install.lifebus.top/auto_uninstall.sh | bash

如需卸载应用列表，您可以手动删除以下目录：

  • 应用目录：${1panel应用目录}/resource/apps/local

  • 应用公共文件目录：/etc/1panel/envs

  • 应用数据目录：${应用持久化目录}

手动安装模式

更新时机由自己把握，手动执行命令。

curl -sSL https://install.lifebus.top/app_install.sh | bash

计划任务模式

将内容写入Shell计划任务中，设定定期执行。

#!/bin/bash

# 此处可以定义代理方案

script_url="https://install.lifebus.top/app_install.sh"

echo "Downloading and executing script from $script_url..."
bash <(curl -sL "$script_url")

echo "Script execution completed."

配置脚本网络代理

如果您的网络环境需要代理，请在脚本执行前配置代理。

可将以下脚本插入到 计划任务模式 的脚本中。

proxy_protocols="http"
proxy_server="server address"
proxy_port="server port"
export http_proxy="$proxy_protocols://$proxy_server:$proxy_port"
export https_proxy="$proxy_protocols://$proxy_server:$proxy_port"

安装 Pre 尝鲜版 应用 (不推荐)

说明：

Pre 尝鲜版 应用为测试版本，可能存在未知问题，我们建议您在测试环境中使用。

安装尝鲜版应用

curl -sSL https://install.lifebus.top/pre_app_install.sh | bash

卸载尝鲜版应用

curl -sSL https://install.lifebus.top/pre_app_uninstall.sh | bash

卸载所有本地应用

通过此脚本，您可以卸载所有本地应用(包含您从其他三方库中导入的应用)，但是不会删除数据。

可能您的库中遗留了一些无用的应用，您可以通过此脚本进行清理。该脚本不影响 自动化脚本 的应用更新。

此脚本必须root用户执行

curl -sSL https://install.lifebus.top/local_app_uninstall.sh | bash

Dockge 导入应用商店

温馨提示： 导入应用列表可能会出现应用冲突，请注意备份数据。

手动安装

下载 dockge 目录，将 dockge 目录内应用列表放置到 Dockge 持久化目录下的 stacks 目录中。

打开 Dockge 面板，点击 扫描堆栈，完成导入应用列表。

常见问题

  • 安装脚本提示

    • 没有权限

      • 请使用 root 用户执行脚本

    • curl: command not found

      • 请安装 curl 命令

      • apt install curl -y

      • yum install curl -y

    • 由于安装脚本的网络问题导致安装失败

      • 请检查网络状况

      • 请尝试重新执行安装脚本

      • 请尝试使用 wget 命令代替 curl 命令

  • 升级失败

    • 检查网络状况与磁盘空间

    • 配置镜像地址

    • 尝试重新升级

    • 进行卸载重装

    • 多次升级依旧失败，请联系我们

  • 安装提示

    • Error: /xxx/xxx/.env file does not exist

      • 请手动创建 .env 文件，不需要填写任何内容的空文件

      • 重新点击安装

  • 前置检查

    • 前置检查 是利用 1Panel 的应用特性，进行安装前的环境检查，如果您的环境不符合要求，将无法安装应用。

    • 关于 前置检查 依旧需要填写 数据库 相关连接信息，是因为其提供的能力并不是完全可靠，避免后期出现问题，我们采用持久化的方式存储。

    • 如果您的环境符合要求，但是依旧无法安装，请联系我们。

site logo

W E L C O M E !

© 2025 梅家部落