1Panel v2在飞牛NAS上的适配与手动编译

1Panel作为现代化开源Linux服务器运维管理面板，凭借高效管理、安全可靠及生态完善等核心特性，在运维领域得到广泛应用。当前飞牛NAS应用商城中1Panel版本仍停留在1.0+阶段，而社区版已迭代至2.0.13等较新版本，新增多项核心功能与性能优化。本文针对飞牛NAS用户群体，系统梳理1Panel核心技术特性、适配前置条件、完整编译打包流程及手动部署方案，助力飞牛用户顺利使用最新版本并发挥其功能价值。

1Panel核心技术特性解析

• 高效运维能力：基于Web图形化界面实现Linux服务器全生命周期管理，覆盖主机监控（CPU、内存、磁盘等指标实时展示）、文件系统管理（权限配置、批量操作）、主流数据库（MySQL/PostgreSQL/MongoDB等）运维及容器（Docker/Kubernetes）编排等核心场景，显著降低运维技术门槛。
• 快速建站支持：深度集成WordPress、Halo、Typecho等开源建站系统，提供域名绑定、SSL证书自动签发与配置、站点定时备份等一键化工具链，将传统建站流程从数小时缩短至分钟级。
• 应用生态体系：内置应用商店聚合数百款高质量开源工具，支持应用一键安装、版本升级与卸载；同时提供自定义应用接入接口，满足个性化业务需求。
• 安全架构设计：采用容器化部署模式实现应用运行环境隔离，最小化漏洞暴露风险；集成主机防火墙、操作日志审计、数据传输加密及存储加密等多层安全组件，保障服务运行稳定性与数据安全性。
• 数据容灾机制：支持本地磁盘、网络共享存储及主流云存储（AWS S3/阿里云OSS/腾讯云COS等）备份，提供一键备份、定时备份与增量备份策略，配合完整的恢复流程，确保数据可追溯性与完整性。

飞牛NAS适配前置条件

• 系统版本要求：飞牛fnOS需升级至0.9.27及以上版本（该版本正式开放应用手动安装接口），建议通过飞牛NAS后台「系统设置-系统升级」路径完成版本校验与升级，升级前需确保设备电量充足或接入外接电源。
• 环境依赖配置：本地编译环境需安装Go 1.18+（1Panel核心开发语言）、Node.js 14+（前端资源构建）、UPX压缩工具（减小二进制文件体积）及Git版本控制工具；飞牛NAS端硬件配置需满足：运行内存≥2GB，存储空间≥10GB（用于存放编译产物及应用运行数据）。
• 网络访问准备：编译过程中需访问GitHub（源码拉取）及Go模块仓库（依赖下载），国内用户建议配置国内代理加速，推荐配置：GOPROXY=https://goproxy.cn,direct，确保网络环境可正常访问相关资源。

1Panel编译打包实操流程

源码获取

通过Git工具克隆1Panel社区版源码，为保障稳定性，建议指定最新稳定版本标签（本文以v2.0.13为例），执行命令如下：

git clone -b v2.0.13 https://github.com/1Panel-dev/1Panel.git 
cd 1Panel # 进入源码根目录

Makefile构建脚本解析

项目根目录下的Makefile为核心构建脚本，关键变量与目标如下：

类别	关键配置	说明
核心变量	GOCMD/GOBUILD	指定Go命令执行路径及构建参数（如编译优化、链接参数等）
核心变量	GOOS/GOARCH	指定目标运行环境，飞牛NAS适配需设置为linux/amd64
	BUILD_PATH	构建产物输出目录，默认路径为./build，可通过参数自定义
	WEB_PATH/CORE_PATH	分别指定前端代码目录（./web）与核心服务代码目录（./cmd/core）
	CORE_NAME/AGENT_NAME	指定编译后核心服务（1panel-core）与Agent服务（1panel-agent）的可执行文件名称
	UPX_BIN	指定UPX压缩工具路径，用于对编译产物进行压缩，减少文件体积
关键目标	build_frontend	执行前端资源构建，包括npm依赖安装、代码编译及静态资源打包
关键目标	build_core_on_linux	Linux环境下编译核心服务，生成1panel-core可执行文件
	build_agent_on_linux	Linux环境下编译Agent服务，生成1panel-agent可执行文件
	build_all	执行全量构建流程，依次完成前端资源构建与后端服务编译

编译执行

全量编译

在Linux编译环境的源码根目录下，执行全量构建命令，触发前端与后端编译流程：

make build_all

构建成功后，产物将输出至BUILD_PATH目录（默认./build），核心产物包括：

• 核心服务可执行文件（1panel-core）
• Agent服务可执行文件（1panel-agent）

应用打包目录创建

在源码根目录（1Panel/）下，执行fnpack工具命令创建飞牛NAS应用打包目录：

fnpack create 1panel

执行后将生成名为1panel的打包目录，包含app、config、1panel等子目录及文件，如下图：

重命名1panel->app->server目录为bin，bin目录将作为应用可执行文件及依赖的存放路径。

将构建成功后的核心服务可执行文件（1panel-core） ，Agent服务可执行文件（1panel-agent），在build目录内，复制到1panel->app->bin目录下

应用基本信息配置

编辑打包目录下的1panel/manifest文件，配置应用核心信息（需确保参数格式正确）：

配置项	配置值	说明
display_name	1Panel	应用显示名称
desc	<p>注：默认运行端口: 24045；</p>新一代的 Linux 服务器运维管理面板	应用描述，测试后发现支持简单的html标签
arch	x86_64	架构，飞牛NAS适配x86_64
source	thirdparty	来源类型，第三方
maintainer	1Panel	开发者
maintainer_url	https://1panel.cn/	开发者官网
distributor	权戈	分发者
distributor_url	https://www.teelm.com/	分发者官网
helpurl	https://1panel.cn/docs/v2/	帮助文档地址
desktop_uidir	ui	前端资源目录
desktop_applaunchname	1panel.Application	应用启动名称

应用权限配置

编辑config/privilege文件，定义应用运行权限（建议以root身份运行以保障功能完整性）：

{
    "defaults": {
        "run-as": "root"
    },
    "username": "1panel",
    "groupname": "1panel"
}

打包为fpk格式

进入打包目录根目录，执行fnpack构建命令生成飞牛NAS支持的fpk安装包：

fnpack build

构建成功后，将在当前目录生成1panel.fpk文件，该文件即为可在飞牛NAS上安装的应用包。

依赖拉取问题解决

编译过程中若出现Go模块依赖拉取失败（表现为报错”module not found”），需配置国内代理加速依赖下载，执行以下命令后重新构建：

• # 配置Go模块代理 export GOPROXY=https://goproxy.cn,direct
• # 清理历史构建产物并重新全量构建 make clean && make build_all
• 若仍存在问题，需检查网络连通性，确保可正常访问GitHub及Go模块仓库。

飞牛NAS手动部署步骤

1. 手动安装操作：登录飞牛NAS管理后台，依次进入「应用中心」页面，点击左下角「手动安装」按钮，在弹出的对话框中：
   • 选择「从电脑上传」或「从NAS添加」
   • 选择生成的1panel.fpk文件
   • 同意
   • 选择安装位置执行安装流程
   • 系统将自动完成安装流程，期间可查看安装进度
   • 安装完成后，将在应用已安装列表中显示1Panel应用。
2. 服务启动与验证：在应用列表中找到1Panel并点击「启动」按钮，启动成功后：
   • 通过浏览器访问http://[NASIP]:24045（默认端口为24045，可在应用配置中修改）
   • 登录后验证主机监控、应用管理等核心功能是否正常运行。

参考资源

• 1Panel官方仓库：https://github.com/1Panel-dev/1Panel（获取最新源码及版本更新日志）
• 飞牛应用开放平台文档：飞牛应用开放平台（获取fnpack工具使用及应用打包规范）
• 1Panel官方文档：https://1panel.cn/docs/v2/（获取1Panel功能使用及故障排查指南）
• 您可以在哔哩哔哩（B 站）上搜索相关教学视频。点击这里