如何离线安装1Panel
内容提要
本文介绍了离线安装1Panel面板的方法，包括离线安装项目和解决PHP安装问题的方法。作者总结了离线安装的便利性。
延伸解读
离线安装的目录参数陷阱
社区提供的离线安装项目虽然简化了流程，但–install-dir参数存在一个容易忽略的细节：默认值/opt/1panel会在该目录下再创建一层1panel文件夹，导致实际安装路径与预期不符。作者建议手动将参数设置为–install-dir /opt，以避免后续管理混乱。这提醒我们，使用第三方脚本时需仔细检查默认配置，否则可能为后续操作埋下隐患。
应用商店离线化的关键步骤
离线安装后应用商店为空，需从互联网端1Panel的/opt/1panel/resource/apps/remote目录拷贝文件到离线端的local目录，并更新。但直接导入镜像后容器虽启动，面板却无法识别，因为数据库apps表中的key被添加了local前缀，resource字段也变为local。必须修改数据库，将key和resource字段改回与在线端一致，并将local目录内容移至remote目录，才能让面板正确识别和管理应用。
PHP安装的特殊处理与镜像一致性
PHP安装与Nginx、MySQL不同，因为1Panel的PHP会在线下载扩展来构建镜像，离线环境下会报错。作者发现数据库runtimes表记录了PHP状态，将其改为normal后重新导入容器即可恢复正常。此外，从互联网端导出的镜像名称和版本必须与离线端完全一致，否则可能无法识别。扩展需在互联网端预先选好，离线端无需修改。
Go语言与Docker的离线优势
作者认为，1Panel和Docker能如此简单地在离线环境安装，得益于Go语言的静态编译特性，生成无依赖的二进制文件，无需联网即可运行。Docker则作为离线使用的利器，在互联网端准备好镜像后直接导入离线端即可使用。这种组合为内网环境提供了便利，但也要求操作者具备一定的数据库和容器知识，以解决识别和配置问题。
Q&A
1Panel官方支持离线安装吗？
1Panel官方不支持离线安装，但社区提供了离线安装的方法。
离线安装1Panel时，安装目录参数需要注意什么？
使用离线安装项目时，其“--install-dir”参数默认是“/opt/1panel”，但安装时会在此目录下再创建1panel文件夹，因此建议手动将参数设置为“--install-dir /opt”。
离线安装后1Panel应用商店是空的，如何导入应用？
可以将互联网端1Panel实例中“/opt/1panel/resource/apps/remote”下的文件拷贝到离线设备的“/opt/1panel/resource/apps/local”下，然后点击更新。之后还需修改数据库，将apps表中key字段的local前缀去掉，并将resource字段从local改为remote，同时把“/opt/1panel/resource/apps/local”下的内容移动到“/opt/1panel/resource/apps/remote”中，再上传数据库并重启。
离线安装1Panel后，PHP安装报错怎么办？
PHP安装报错是因为1Panel的PHP会在线下载扩展来构建镜像。可以修改数据库，在runtimes表中将PHP的状态改为normal，然后上传数据库并重新导入容器，PHP即可正常。
离线安装1Panel时，从互联网端导出的镜像有什么要求？
从互联网端导出的镜像名字和版本必须和离线端一样，否则可能识别不到。扩展等在互联网端选择好即可，离线端不需要修改。
为什么1Panel和Docker能较简单地在离线环境下安装？
因为1Panel是Go写的程序，能无依赖、静态编译，在没网的情况下比较方便；Docker也是离线使用的利器，在互联网准备好镜像直接拿到离线端就能用。
