1Panel 这个服务器可视化管理面板最近在运维圈子里热度一直不低。很多人拿它和宝塔对比之后都想知道在自己的环境里怎么把它装起来。上周还有个读者专门问我“Windows 11 上能不能装 1Panel”问的人多了我觉得不如直接写一篇完整的安装实践把 Linux 云服务器和 Windows 11 两条安装路径都梳理清楚。1Panel 和传统面板最大的区别是它默认跑在 Docker 容器体系里底层用 Go 语言开发界面走的是清爽的现代化风格没有广告、没有强制绑定账号完全开源。它能干的活不少快速建站、数据库管理、容器管理、系统监控、定时备份、日志清理基本上一个运维日常要碰的东西都覆盖到了。适合谁用呢如果你不想每条命令都在终端里死记硬背又受够了老牌面板的弹窗和捆绑那 1Panel 值得花半小时装上试试。1. 1Panel 是什么为什么值得装1.1 核心功能速览我不喜欢一上来就罗列功能清单但为了后面讲安装过程时不至于让新手一头雾水这里还是简单过一遍 1Panel 常用的几个模块网站管理内置 OpenResty 和 Nginx 环境可以创建静态站点、反向代理站点还能一键申请 Lets Encrypt 免费证书。数据库管理支持 MySQL、MariaDB、PostgreSQL、Redis创建、备份、远程访问权限控制在网页里就能完成。容器管理基于 Docker可以直接查看容器状态、日志、进入终端也可以自己编辑 Compose 文件部署服务。监控告警CPU、内存、磁盘、网络流量曲线都在首页能设置告警阈值邮件和 Webhook 通知都能接。文件管理服务器上的目录浏览、上传下载、在线编辑虽然不如 SFTP 客户端功能全面但应急时候挺好用。计划任务定时备份、清理日志、执行 Shell 脚本支持整点、周期、Cron 表达式三种模式。单看功能1Panel 并没有比同类产品多出什么颠覆性的东西。它的价值在于把这些功能用一套干净的界面串起来不让你在安全和便利之间做太多妥协。1.2 和宝塔相比它的优势在哪我知道聊面板就绕不开宝塔直接给结论。宝塔用的人多生态和插件确实成熟但 1Panel 有几个点是我个人比较欣赏的无广告、不弹窗。宝塔免费版会推会员、推插件甚至升级后有时候会卡住要你登录账号。1Panel 装完就是装完没有这些乱七八糟的事。应用容器化。1Panel 里跑的 OpenResty、MySQL、Redis 都是独立的 Docker 容器删掉应用不会在系统里留下依赖残留。出了问题直接把容器删了重建比传统面板改配置省心很多。安全设计更现代。面板本身带“安全入口”这个概念就是一个随机字符串路径访问面板必须带这个路径才打得开相当于白名单 路径隐藏双保险。Go 语言单二进制安装快、占用低整体响应速度明显比同配置下其他面板轻快。这几点不是说宝塔不行而是如果你有选择空间不妨给 1Panel 一个机会。1.3 安装前需要想清楚的三件事在敲任何命令之前有三个问题值得先琢磨明白。第一你装这个面板是为了学 Linux还是为了管生产服务器。目的不同安装方式完全不同。面试时别说自己在 Windows 上练过 1Panel这在生产环境里并不是一个严肃的部署方式。第二你的端口规划。1Panel 默认会随机生成一个端口类似 28080 这种但我强烈建议你安装时自己指定一个。随机端口记不住而且有些云厂商的端口扫描工具看到陌生端口反而会重点盯防。固定一个非主流端口比如 18080、28443 这类又方便防火墙放行又不容易被脚本扫描撞上。第三你对 Docker 的接受度。1Panel 几乎所有核心应用都基于 Docker如果服务器内存小于 1GB跑 MySQL 加 OpenResty 会很吃力。我自己测试过2GB 内存是最舒服的配置装完这些服务还能剩余一半空闲。2. 安装方式选型裸机、虚拟机还是 WSL2.1 Windows 11 用户到底该选哪条路网上关于“Windows 上装 1Panel”的讨论很多核心原因在于 1Panel 官方只支持 Linux。Windows 不是装不上是要绕个弯。目前主流的路径有四条方案原理适合场景推荐程度WSL2Windows 子系统在 Windows 里跑一个轻量 Linux 虚拟机环境学习、开发测试、本地折腾非常推荐VMware/VirtualBox 虚拟机完整虚拟化装一个纯 Linux 桌面或服务器版需要完整 Linux 图形环境或内核实验一般Docker DesktopWindows 上跑 Docker 容器再容器化运行 1Panel已有 Docker Desktop 工作流的人不推荐云服务器买一台 Linux VPS 远程安装生产环境、个人网站、真实项目强烈推荐从成本和效率来看WSL2 是 Windows 11 上最平滑的路线。它不像虚拟机那样要分配固定内存和磁盘启动一个 Ubuntu 子系统也就是几秒钟的事文件和 Windows 之间还能互访。有读者担心的“WSL2 是不是不正式”这个问题我这么理解WSL2 里的 Ubuntu 是一个真实的 Linux 内核跑 1Panel 的安装脚本、systemd 服务、Docker 容器都没有问题作为学习和本地建站已经够用了。2.2 为什么我不推荐 Docker Desktop 跑 1Panel很多 Docker 玩家会问我已经装了 Docker Desktop直接在容器里跑 1Panel 镜像不就行了理论上可以但实际操作很别扭。1Panel 安装脚本会自己安装 Docker、初始化目录结构、注册 systemd 服务这些在 Windows Docker Desktop 的 Linux 容器里不是不能用而是会出现端口映射、卷挂载、网络模式一堆绕不开的麻烦。更关键的是1Panel 本身就是用来管理 Docker 的你在容器里装一个 Docker 管理面板它再尝试去控制宿主机的 Docker 环境这在权限和隔离上很容易卡住。所以我的建议很简单Windows 本地就老老实实开 WSL2生产环境就买台云服务器。两条路都通别在 Docker Desktop 上较劲。2.3 硬件要求与系统兼容性1Panel 官方对 Linux 服务端的要求是内核 3.10 以上、内存 1GB 起步、建议 2GB。这些条件放到 WSL2 上毫无压力Windows 11 的 WSL2 默认支持 systemd虚拟机平台功能启用了之后Ubuntu 22.04 或者 24.04 都能正常运行 1Panel。需要注意的点是Windows 11 家庭版也能用 WSL2不需要升级专业版。只要 BIOS 里开了虚拟化Intel VT-x 或 AMD SVM安装过程中就不会出幺蛾子。3. 实操Windows 11 上用 WSL2 安装 1Panel 全流程3.1 第一步启用 WSL2 并安装 Ubuntu这一步是整个安装过程的基础很多人卡在这一关倒不是操作复杂而是权限不够。以管理员身份打开 PowerShell点开“开始”菜单输入“PowerShell”右键选择“以管理员身份运行”。然后执行wsl --install这条命令会完成三件事启用“适用于 Linux 的 Windows 子系统”功能、启用“虚拟机平台”功能、安装默认发行版 Ubuntu。执行过程中如果提示需要重启记得重启之后继续。重启完开始菜单里会出现 Ubuntu 的图标第一次启动会让你设置 Linux 用户名和密码。用户名别用 root用一个普通用户比如你自己的英文名。密码输入的时候是不显示的别以为键盘坏了。3.2 第二步给 Ubuntu 换源并更新系统Ubuntu 装好后先别急着装 1Panel我建议先把软件源换成国内镜像不然 apt 下载东西速度可能是几 KB 每秒等到怀疑人生。备份原来的源文件sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak然后用 sed 把官方源替换成国内源。这一步不同版本 Ubuntu 的源格式不同最简单的方式是直接编辑文件把archive.ubuntu.com和security.ubuntu.com替换成你常用的镜像源地址。以 Ubuntu 22.04 为例sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo sed -i s/security.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list更新系统sudo apt update sudo apt upgrade -y这个过程可能要几分钟正好可以把接下来要用的命令先准备好。升级完成之后顺手把 curl 装上sudo apt install -y curl3.3 第三步执行 1Panel 一键安装脚本现在进入正题。官方提供的安装脚本是分两步执行的curl -sSL https://resource.1panel.hk/quick_start.sh -o quick_start.sh sudo bash quick_start.sh如果你在非大陆网络环境直接用官方地址没问题如果下载脚本很慢可以把域名换成resource.1panel.cn或者从 GitHub 仓库获取脚本后手动执行。脚本运行之后会进入交互式安装界面你需要按提示输入几个关键参数安装目录默认是/opt直接回车。面板端口默认随机生成强烈建议改成自己好记的端口比如18080。面板用户名默认 admin可以换成你自己的。面板密码默认随机生成这个我建议自己设一个 20 位以上的强密码后面登录要用。安全入口默认随机字符串保留默认即可这是面板网址后面跟着的那一段路径。整个过程大概一两分钟。安装完成会在终端里打印面板访问地址、用户名、密码这些信息务必先截图或抄下来。3.4 第四步初始化面板并登录安装完之后先用下面命令确认面板服务状态systemctl status 1panel如果输出里有active (running)说明服务正常。然后打开 Windows 浏览器输入安装脚本最后显示的地址。这里有两种情况如果 WSL2 版本较新通常可以直接访问http://localhost:18080/安全入口因为 Windows 会自动做 localhost 转发。如果不行需要先在 WSL2 里查一下 Ubuntu 的 IP 地址hostname -I拿到类似172.24.x.x的地址之后用http://172.24.x.x:18080/安全入口访问。登录面板之后第一件事是去“面板设置”里确认两步验证功能建议立刻开启。这一步不是让你设置复杂到记不住的东西而是防止你的服务器被扫到之后被尝试暴力登录。开启需要手机装个 TOTP 验证器比如 Google Authenticator 或者 Microsoft Authenticator扫码绑定即可。3.5 第五步解决 Windows 访问 WSL2 服务的端口转发问题如果前面 localhost 直接能通这一步可以跳过。但如果你发现 WSL2 内部可以访问面板Windows 浏览器却总是打不开大概率是端口转发没做好。WSL2 本质上是一个轻量虚拟机它的网络是通过 NAT 模式共享的。想要让 Windows 宿主机访问 WSL2 里的服务需要手动加一条端口转发规则。在 Windows 管理员 PowerShell 里执行netsh interface portproxy add v4tov4 listenport18080 listenaddress0.0.0.0 connectport18080 connectaddress172.24.x.x这里的172.24.x.x替换成你自己的 WSL2 IP。加完之后用http://localhost:18080/安全入口访问试试。如果还是不行检查 Windows 防火墙是否拦截了 18080 端口。在管理员 PowerShell 里放行端口New-NetFirewallRule -DisplayName 1Panel -Direction Inbound -Protocol TCP -LocalPort 18080 -Action Allow这个坑我踩过好几次很多时候不是 WSL2 的问题而是 Windows Defender 防火墙默认拦掉了入站请求。加完规则立刻就能通。4. 实操Linux 云服务器上的安装与初始化4.1 用 curl 无交互安装如果你有云服务器安装流程比 WSL2 还要简单。因为云服务器本身就是 Linux 环境不需要额外的虚拟化层。连接上服务器之后确认系统是 CentOS 7/8、Ubuntu 20.04/22.04 或者 Debian 11/12然后执行curl -sSL https://resource.1panel.hk/quick_start.sh -o quick_start.sh sudo bash quick_start.sh安装过程同样会问你端口、用户名、密码、安全入口这几个参数。有一点和 WSL2 不同云服务器上安装时如果你是 CentOS 且没有内置 curl可能需要先用yum install -y curl装一下。安装完成之后终端里会显示类似下面的信息面板地址: http://服务器公网IP:18080/xxxxxxxx 用户名: admin 密码: xxxxxxxxxxxxxxxx到这里先别高兴太早公网 IP 的端口大概率还是不通的因为云厂商默认开启了安全组防火墙。4.2 自定义端口和安装目录有朋友安装的时候遇到过 80 端口被占、或者 3306 被占的情况原因通常是之前装过其他 Web 或数据库服务。1Panel 安装时最推荐的姿势是面板端口选一个非主流端口比如 18080不要用 8080因为 8080 经常被其他中间件占用也经常被扫描器盯上。数据库端口保持默认 3306 没问题但记得不要让 MySQL 对公网开放监听1Panel 里创建数据库的时候可以设置访问权限为“仅本机”。安装目录如果磁盘空间不够比如系统盘只有 20GB建议把安装目录指定到数据盘比如/data这样以后镜像和网站文件不会挤压系统盘空间。4.3 防火墙和安全组放行云服务器有自上而下两道防火墙云控制台的安全组规则和服务器内部的 firewalld/ufw。两道门都得打开端口才通。如果系统是 CentOS/Rocky放行端口sudo firewall-cmd --permanent --add-port18080/tcp sudo firewall-cmd --reload如果是 Ubuntu用 ufwsudo ufw allow 18080/tcp sudo ufw status注意如果你的 ufw 之前是开启状态执行ufw allow之后还要确保 SSH 22 端口也被放行了不然最坏情况是你把自己关在服务器外面进不去。我遇到过不止一次这种悲剧看到面板端口通了结果 SSH 断了因为之前 ufw 规则没有保留 22 端口。云控制台安全组才是最后决定生死的一环。去你用的云厂商控制台找到这台服务器的安全组添加入站规则协议 TCP、端口 18080、来源 0.0.0.0/0。添加完成后用浏览器访问面板地址应该就能看到登录页面了。5. 应用商店装完面板后第一件事5.1 安装 OpenResty、MySQL、Redis面板装完下一步自然是搭环境。1Panel 左侧菜单里有个“应用商店”里面能找到 OpenResty、Nginx、MySQL、Redis、PostgreSQL、MongoDB 等常用服务。安装操作非常简单每个应用卡片上直接点安装会弹出配置窗口要你填端口、版本、资源限制等参数。以 MySQL 为例端口默认 3306保持不动。root 密码自己设置一个别用默认的随机密码不然以后记都没地方记。容量限制建议不要设置得太紧MySQL 日常用 512MB 内存限制都够跑了。点确认之后1Panel 会调用 Docker 拉取镜像并启动容器。这个过程取决于服务器带宽一般在 1 到 3 分钟之间。安装完可以在“容器”页面看到这些容器的运行状态。5.2 创建第一个网站1Panel 里创建网站的逻辑是这样的先装好 OpenResty然后在“网站”页面点“创建网站”选择“静态网站”或“反向代理”。静态网站适合放纯 HTML、Vue、React 构建产物反向代理适合把请求转给后端的 Python、Node.js、Java 服务。创建时需要填域名如果你没有域名可以临时填一个本地测试域名比如test.local。网站目录默认在/opt/1panel/apps/openresty/sites/下面可以自己改。运行目录一般就是网站目录本身。创建完之后网站会立即出现在列表里状态是“运行中”。如果你想加 HTTPS可以在网站详情里点“设置证书”选 Lets Encrypt 并填好邮箱1Panel 会自动证书签发和续期省掉了手动更新证书的麻烦。5.3 定时备份设置备份是很多人忽略但最不能忽略的功能。1Panel 的计划任务支持备份数据库、备份网站也可以备份整个面板配置。我习惯的做法是在“计划任务”里新建一个“备份数据库”任务选择 MySQL备份方式“本地存储”执行周期选“每天”时间为凌晨 3 点。再建一个“备份网站”任务网站目录选择 OpenResty 站点目录同样每天执行。备份留存数量设置为 7 份超过自动清理避免把磁盘塞满。如果你有对象存储比如阿里云 OSS、腾讯云 COS可以在 1Panel 的“设置-存储管理”里添加云存储把备份目标选到云端。即使服务器全盘崩溃备份也在你手里。6. 常见问题与排查技巧实录6.1 一键脚本下载失败怎么办国内服务器执行 curl 下载脚本的时候偶尔会因为网络问题卡很久或者直接失败。这种情况先别反复重试直接换源。curl -sSL https://resource.1panel.cn/quick_start.sh -o quick_start.sh sudo bash quick_start.sh如果仍然失败可以去 GitHub 仓库手动下载脚本再执行。注意脚本执行的时候要用sudo bash quick_start.sh不要直接./quick_start.sh否则可能因为权限问题报错。6.2 面板端口无法访问怎么排查遇到这个问题我建议按这个顺序排查别跳步骤先确认服务状态systemctl status 1panel如果显示 failed 或 inactive看日志/var/log/1panel.log里最后的错误信息。确认端口监听ss -tlnp | grep 18080如果没输出说明 1Panel 没监听这个端口大概率是安装时端口没写对。确认服务器防火墙CentOS 检查 firewalldUbuntu 检查 ufw是不是把端口挡了。确认云安全组安全组规则有没有添加入站端口。这一步特别容易漏因为本地服务器不会有安全组概念只有云服务器才有。四步走完基本能定位 80% 的问题。6.3 WSL2 重启后 1Panel 服务不启动新版 WSL2 已经支持 systemd正常情况下重启 Ubuntu 或者 Windows 之后1Panel 服务会自动启动。如果你发现没有自动启动可以检查一下 /etc/wsl.conf 是否存在内容里是否有[boot] systemdtrue没有的话就添上然后在 PowerShell 里执行wsl --shutdown重新打开 Ubuntu。之后systemctl status 1panel就正常了。6.4 忘记面板密码怎么办这个不用重装系统1Panel 提供了命令行重置工具。在服务器终端执行sudo 1pctl reset-password系统会提示你输入新密码设置完成后用新密码登录面板即可。如果你想查看当前用户名可以用1pctl user-info查看。6.5 磁盘空间莫名变小Docker 镜像和容器日志是磁盘杀手。1Panel 的“设置-系统-磁盘清理”里可以一键清理未使用的镜像、悬空镜像和容器日志相当好用。也可以在容器页面里给每个容器配置日志轮转限制防止单个容器日志无限膨胀。7. 个人经验几个值得长期坚持的使用习惯文章写到这里安装的路径基本都覆盖到了。最后聊几个我在实际使用中沉淀下来的小习惯算不上什么高深技巧但踩过坑之后确实很庆幸坚持下来了。第一个习惯是安装时永远手动指定面板端口和密码。不要用默认随机值。随机生成的密码我遇到过几次复制错的情况换行符没复制全登录的时候卡了半天。手动指定一个自己熟悉的端口和密码后面所有配置都会省心。第二个习惯是定期做备份恢复演练。1Panel 的备份功能很多人都知道但真正把备份恢复到新服务器上测试过一次的人不多。我建议你每隔一段时间把备份的 tar 包下载到一台临时机器上用 1Panel 的“导入备份”功能恢复一下确认数据完整可用。备份不是拷出来就万事大吉恢复不了等于没有备份。第三个习惯是面板的安全入口尽量保留默认随机值不要为了方便把它删掉。安全入口相当于给面板加了一层路径隐藏即使有人扫到你的端口也要猜中那一长串路径才能看到登录页。这是成本最低的安全防护。还有一个小技巧1Panel 的命令行工具1pctl除了重置密码还能查看面板版本、升级面板、查看服务状态。以后面板网页打不开的时候先跑一遍1pctl status看看服务在不在不要一上来就重启服务器浪费时间。希望这篇安装踩坑记录能帮到你。不管是在 Windows 11 上用 WSL2 练手还是直接上云服务器部署生产环境1Panel 这套面板的上手体验都值得你亲自动手试一试。
1Panel 这个服务器可视化管理面板最近在运维圈子里热度一直不低。很多人拿它和宝塔对比之后都想知道在自己的环境里怎么把它装起来。上周还有个读者专门问我“Windows 11 上能不能装 1Panel”问的人多了我觉得不如直接写一篇完整的安装实践把 Linux 云服务器和 Windows 11 两条安装路径都梳理清楚。1Panel 和传统面板最大的区别是它默认跑在 Docker 容器体系里底层用 Go 语言开发界面走的是清爽的现代化风格没有广告、没有强制绑定账号完全开源。它能干的活不少快速建站、数据库管理、容器管理、系统监控、定时备份、日志清理基本上一个运维日常要碰的东西都覆盖到了。适合谁用呢如果你不想每条命令都在终端里死记硬背又受够了老牌面板的弹窗和捆绑那 1Panel 值得花半小时装上试试。1. 1Panel 是什么为什么值得装1.1 核心功能速览我不喜欢一上来就罗列功能清单但为了后面讲安装过程时不至于让新手一头雾水这里还是简单过一遍 1Panel 常用的几个模块网站管理内置 OpenResty 和 Nginx 环境可以创建静态站点、反向代理站点还能一键申请 Lets Encrypt 免费证书。数据库管理支持 MySQL、MariaDB、PostgreSQL、Redis创建、备份、远程访问权限控制在网页里就能完成。容器管理基于 Docker可以直接查看容器状态、日志、进入终端也可以自己编辑 Compose 文件部署服务。监控告警CPU、内存、磁盘、网络流量曲线都在首页能设置告警阈值邮件和 Webhook 通知都能接。文件管理服务器上的目录浏览、上传下载、在线编辑虽然不如 SFTP 客户端功能全面但应急时候挺好用。计划任务定时备份、清理日志、执行 Shell 脚本支持整点、周期、Cron 表达式三种模式。单看功能1Panel 并没有比同类产品多出什么颠覆性的东西。它的价值在于把这些功能用一套干净的界面串起来不让你在安全和便利之间做太多妥协。1.2 和宝塔相比它的优势在哪我知道聊面板就绕不开宝塔直接给结论。宝塔用的人多生态和插件确实成熟但 1Panel 有几个点是我个人比较欣赏的无广告、不弹窗。宝塔免费版会推会员、推插件甚至升级后有时候会卡住要你登录账号。1Panel 装完就是装完没有这些乱七八糟的事。应用容器化。1Panel 里跑的 OpenResty、MySQL、Redis 都是独立的 Docker 容器删掉应用不会在系统里留下依赖残留。出了问题直接把容器删了重建比传统面板改配置省心很多。安全设计更现代。面板本身带“安全入口”这个概念就是一个随机字符串路径访问面板必须带这个路径才打得开相当于白名单 路径隐藏双保险。Go 语言单二进制安装快、占用低整体响应速度明显比同配置下其他面板轻快。这几点不是说宝塔不行而是如果你有选择空间不妨给 1Panel 一个机会。1.3 安装前需要想清楚的三件事在敲任何命令之前有三个问题值得先琢磨明白。第一你装这个面板是为了学 Linux还是为了管生产服务器。目的不同安装方式完全不同。面试时别说自己在 Windows 上练过 1Panel这在生产环境里并不是一个严肃的部署方式。第二你的端口规划。1Panel 默认会随机生成一个端口类似 28080 这种但我强烈建议你安装时自己指定一个。随机端口记不住而且有些云厂商的端口扫描工具看到陌生端口反而会重点盯防。固定一个非主流端口比如 18080、28443 这类又方便防火墙放行又不容易被脚本扫描撞上。第三你对 Docker 的接受度。1Panel 几乎所有核心应用都基于 Docker如果服务器内存小于 1GB跑 MySQL 加 OpenResty 会很吃力。我自己测试过2GB 内存是最舒服的配置装完这些服务还能剩余一半空闲。2. 安装方式选型裸机、虚拟机还是 WSL2.1 Windows 11 用户到底该选哪条路网上关于“Windows 上装 1Panel”的讨论很多核心原因在于 1Panel 官方只支持 Linux。Windows 不是装不上是要绕个弯。目前主流的路径有四条方案原理适合场景推荐程度WSL2Windows 子系统在 Windows 里跑一个轻量 Linux 虚拟机环境学习、开发测试、本地折腾非常推荐VMware/VirtualBox 虚拟机完整虚拟化装一个纯 Linux 桌面或服务器版需要完整 Linux 图形环境或内核实验一般Docker DesktopWindows 上跑 Docker 容器再容器化运行 1Panel已有 Docker Desktop 工作流的人不推荐云服务器买一台 Linux VPS 远程安装生产环境、个人网站、真实项目强烈推荐从成本和效率来看WSL2 是 Windows 11 上最平滑的路线。它不像虚拟机那样要分配固定内存和磁盘启动一个 Ubuntu 子系统也就是几秒钟的事文件和 Windows 之间还能互访。有读者担心的“WSL2 是不是不正式”这个问题我这么理解WSL2 里的 Ubuntu 是一个真实的 Linux 内核跑 1Panel 的安装脚本、systemd 服务、Docker 容器都没有问题作为学习和本地建站已经够用了。2.2 为什么我不推荐 Docker Desktop 跑 1Panel很多 Docker 玩家会问我已经装了 Docker Desktop直接在容器里跑 1Panel 镜像不就行了理论上可以但实际操作很别扭。1Panel 安装脚本会自己安装 Docker、初始化目录结构、注册 systemd 服务这些在 Windows Docker Desktop 的 Linux 容器里不是不能用而是会出现端口映射、卷挂载、网络模式一堆绕不开的麻烦。更关键的是1Panel 本身就是用来管理 Docker 的你在容器里装一个 Docker 管理面板它再尝试去控制宿主机的 Docker 环境这在权限和隔离上很容易卡住。所以我的建议很简单Windows 本地就老老实实开 WSL2生产环境就买台云服务器。两条路都通别在 Docker Desktop 上较劲。2.3 硬件要求与系统兼容性1Panel 官方对 Linux 服务端的要求是内核 3.10 以上、内存 1GB 起步、建议 2GB。这些条件放到 WSL2 上毫无压力Windows 11 的 WSL2 默认支持 systemd虚拟机平台功能启用了之后Ubuntu 22.04 或者 24.04 都能正常运行 1Panel。需要注意的点是Windows 11 家庭版也能用 WSL2不需要升级专业版。只要 BIOS 里开了虚拟化Intel VT-x 或 AMD SVM安装过程中就不会出幺蛾子。3. 实操Windows 11 上用 WSL2 安装 1Panel 全流程3.1 第一步启用 WSL2 并安装 Ubuntu这一步是整个安装过程的基础很多人卡在这一关倒不是操作复杂而是权限不够。以管理员身份打开 PowerShell点开“开始”菜单输入“PowerShell”右键选择“以管理员身份运行”。然后执行wsl --install这条命令会完成三件事启用“适用于 Linux 的 Windows 子系统”功能、启用“虚拟机平台”功能、安装默认发行版 Ubuntu。执行过程中如果提示需要重启记得重启之后继续。重启完开始菜单里会出现 Ubuntu 的图标第一次启动会让你设置 Linux 用户名和密码。用户名别用 root用一个普通用户比如你自己的英文名。密码输入的时候是不显示的别以为键盘坏了。3.2 第二步给 Ubuntu 换源并更新系统Ubuntu 装好后先别急着装 1Panel我建议先把软件源换成国内镜像不然 apt 下载东西速度可能是几 KB 每秒等到怀疑人生。备份原来的源文件sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak然后用 sed 把官方源替换成国内源。这一步不同版本 Ubuntu 的源格式不同最简单的方式是直接编辑文件把archive.ubuntu.com和security.ubuntu.com替换成你常用的镜像源地址。以 Ubuntu 22.04 为例sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo sed -i s/security.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list更新系统sudo apt update sudo apt upgrade -y这个过程可能要几分钟正好可以把接下来要用的命令先准备好。升级完成之后顺手把 curl 装上sudo apt install -y curl3.3 第三步执行 1Panel 一键安装脚本现在进入正题。官方提供的安装脚本是分两步执行的curl -sSL https://resource.1panel.hk/quick_start.sh -o quick_start.sh sudo bash quick_start.sh如果你在非大陆网络环境直接用官方地址没问题如果下载脚本很慢可以把域名换成resource.1panel.cn或者从 GitHub 仓库获取脚本后手动执行。脚本运行之后会进入交互式安装界面你需要按提示输入几个关键参数安装目录默认是/opt直接回车。面板端口默认随机生成强烈建议改成自己好记的端口比如18080。面板用户名默认 admin可以换成你自己的。面板密码默认随机生成这个我建议自己设一个 20 位以上的强密码后面登录要用。安全入口默认随机字符串保留默认即可这是面板网址后面跟着的那一段路径。整个过程大概一两分钟。安装完成会在终端里打印面板访问地址、用户名、密码这些信息务必先截图或抄下来。3.4 第四步初始化面板并登录安装完之后先用下面命令确认面板服务状态systemctl status 1panel如果输出里有active (running)说明服务正常。然后打开 Windows 浏览器输入安装脚本最后显示的地址。这里有两种情况如果 WSL2 版本较新通常可以直接访问http://localhost:18080/安全入口因为 Windows 会自动做 localhost 转发。如果不行需要先在 WSL2 里查一下 Ubuntu 的 IP 地址hostname -I拿到类似172.24.x.x的地址之后用http://172.24.x.x:18080/安全入口访问。登录面板之后第一件事是去“面板设置”里确认两步验证功能建议立刻开启。这一步不是让你设置复杂到记不住的东西而是防止你的服务器被扫到之后被尝试暴力登录。开启需要手机装个 TOTP 验证器比如 Google Authenticator 或者 Microsoft Authenticator扫码绑定即可。3.5 第五步解决 Windows 访问 WSL2 服务的端口转发问题如果前面 localhost 直接能通这一步可以跳过。但如果你发现 WSL2 内部可以访问面板Windows 浏览器却总是打不开大概率是端口转发没做好。WSL2 本质上是一个轻量虚拟机它的网络是通过 NAT 模式共享的。想要让 Windows 宿主机访问 WSL2 里的服务需要手动加一条端口转发规则。在 Windows 管理员 PowerShell 里执行netsh interface portproxy add v4tov4 listenport18080 listenaddress0.0.0.0 connectport18080 connectaddress172.24.x.x这里的172.24.x.x替换成你自己的 WSL2 IP。加完之后用http://localhost:18080/安全入口访问试试。如果还是不行检查 Windows 防火墙是否拦截了 18080 端口。在管理员 PowerShell 里放行端口New-NetFirewallRule -DisplayName 1Panel -Direction Inbound -Protocol TCP -LocalPort 18080 -Action Allow这个坑我踩过好几次很多时候不是 WSL2 的问题而是 Windows Defender 防火墙默认拦掉了入站请求。加完规则立刻就能通。4. 实操Linux 云服务器上的安装与初始化4.1 用 curl 无交互安装如果你有云服务器安装流程比 WSL2 还要简单。因为云服务器本身就是 Linux 环境不需要额外的虚拟化层。连接上服务器之后确认系统是 CentOS 7/8、Ubuntu 20.04/22.04 或者 Debian 11/12然后执行curl -sSL https://resource.1panel.hk/quick_start.sh -o quick_start.sh sudo bash quick_start.sh安装过程同样会问你端口、用户名、密码、安全入口这几个参数。有一点和 WSL2 不同云服务器上安装时如果你是 CentOS 且没有内置 curl可能需要先用yum install -y curl装一下。安装完成之后终端里会显示类似下面的信息面板地址: http://服务器公网IP:18080/xxxxxxxx 用户名: admin 密码: xxxxxxxxxxxxxxxx到这里先别高兴太早公网 IP 的端口大概率还是不通的因为云厂商默认开启了安全组防火墙。4.2 自定义端口和安装目录有朋友安装的时候遇到过 80 端口被占、或者 3306 被占的情况原因通常是之前装过其他 Web 或数据库服务。1Panel 安装时最推荐的姿势是面板端口选一个非主流端口比如 18080不要用 8080因为 8080 经常被其他中间件占用也经常被扫描器盯上。数据库端口保持默认 3306 没问题但记得不要让 MySQL 对公网开放监听1Panel 里创建数据库的时候可以设置访问权限为“仅本机”。安装目录如果磁盘空间不够比如系统盘只有 20GB建议把安装目录指定到数据盘比如/data这样以后镜像和网站文件不会挤压系统盘空间。4.3 防火墙和安全组放行云服务器有自上而下两道防火墙云控制台的安全组规则和服务器内部的 firewalld/ufw。两道门都得打开端口才通。如果系统是 CentOS/Rocky放行端口sudo firewall-cmd --permanent --add-port18080/tcp sudo firewall-cmd --reload如果是 Ubuntu用 ufwsudo ufw allow 18080/tcp sudo ufw status注意如果你的 ufw 之前是开启状态执行ufw allow之后还要确保 SSH 22 端口也被放行了不然最坏情况是你把自己关在服务器外面进不去。我遇到过不止一次这种悲剧看到面板端口通了结果 SSH 断了因为之前 ufw 规则没有保留 22 端口。云控制台安全组才是最后决定生死的一环。去你用的云厂商控制台找到这台服务器的安全组添加入站规则协议 TCP、端口 18080、来源 0.0.0.0/0。添加完成后用浏览器访问面板地址应该就能看到登录页面了。5. 应用商店装完面板后第一件事5.1 安装 OpenResty、MySQL、Redis面板装完下一步自然是搭环境。1Panel 左侧菜单里有个“应用商店”里面能找到 OpenResty、Nginx、MySQL、Redis、PostgreSQL、MongoDB 等常用服务。安装操作非常简单每个应用卡片上直接点安装会弹出配置窗口要你填端口、版本、资源限制等参数。以 MySQL 为例端口默认 3306保持不动。root 密码自己设置一个别用默认的随机密码不然以后记都没地方记。容量限制建议不要设置得太紧MySQL 日常用 512MB 内存限制都够跑了。点确认之后1Panel 会调用 Docker 拉取镜像并启动容器。这个过程取决于服务器带宽一般在 1 到 3 分钟之间。安装完可以在“容器”页面看到这些容器的运行状态。5.2 创建第一个网站1Panel 里创建网站的逻辑是这样的先装好 OpenResty然后在“网站”页面点“创建网站”选择“静态网站”或“反向代理”。静态网站适合放纯 HTML、Vue、React 构建产物反向代理适合把请求转给后端的 Python、Node.js、Java 服务。创建时需要填域名如果你没有域名可以临时填一个本地测试域名比如test.local。网站目录默认在/opt/1panel/apps/openresty/sites/下面可以自己改。运行目录一般就是网站目录本身。创建完之后网站会立即出现在列表里状态是“运行中”。如果你想加 HTTPS可以在网站详情里点“设置证书”选 Lets Encrypt 并填好邮箱1Panel 会自动证书签发和续期省掉了手动更新证书的麻烦。5.3 定时备份设置备份是很多人忽略但最不能忽略的功能。1Panel 的计划任务支持备份数据库、备份网站也可以备份整个面板配置。我习惯的做法是在“计划任务”里新建一个“备份数据库”任务选择 MySQL备份方式“本地存储”执行周期选“每天”时间为凌晨 3 点。再建一个“备份网站”任务网站目录选择 OpenResty 站点目录同样每天执行。备份留存数量设置为 7 份超过自动清理避免把磁盘塞满。如果你有对象存储比如阿里云 OSS、腾讯云 COS可以在 1Panel 的“设置-存储管理”里添加云存储把备份目标选到云端。即使服务器全盘崩溃备份也在你手里。6. 常见问题与排查技巧实录6.1 一键脚本下载失败怎么办国内服务器执行 curl 下载脚本的时候偶尔会因为网络问题卡很久或者直接失败。这种情况先别反复重试直接换源。curl -sSL https://resource.1panel.cn/quick_start.sh -o quick_start.sh sudo bash quick_start.sh如果仍然失败可以去 GitHub 仓库手动下载脚本再执行。注意脚本执行的时候要用sudo bash quick_start.sh不要直接./quick_start.sh否则可能因为权限问题报错。6.2 面板端口无法访问怎么排查遇到这个问题我建议按这个顺序排查别跳步骤先确认服务状态systemctl status 1panel如果显示 failed 或 inactive看日志/var/log/1panel.log里最后的错误信息。确认端口监听ss -tlnp | grep 18080如果没输出说明 1Panel 没监听这个端口大概率是安装时端口没写对。确认服务器防火墙CentOS 检查 firewalldUbuntu 检查 ufw是不是把端口挡了。确认云安全组安全组规则有没有添加入站端口。这一步特别容易漏因为本地服务器不会有安全组概念只有云服务器才有。四步走完基本能定位 80% 的问题。6.3 WSL2 重启后 1Panel 服务不启动新版 WSL2 已经支持 systemd正常情况下重启 Ubuntu 或者 Windows 之后1Panel 服务会自动启动。如果你发现没有自动启动可以检查一下 /etc/wsl.conf 是否存在内容里是否有[boot] systemdtrue没有的话就添上然后在 PowerShell 里执行wsl --shutdown重新打开 Ubuntu。之后systemctl status 1panel就正常了。6.4 忘记面板密码怎么办这个不用重装系统1Panel 提供了命令行重置工具。在服务器终端执行sudo 1pctl reset-password系统会提示你输入新密码设置完成后用新密码登录面板即可。如果你想查看当前用户名可以用1pctl user-info查看。6.5 磁盘空间莫名变小Docker 镜像和容器日志是磁盘杀手。1Panel 的“设置-系统-磁盘清理”里可以一键清理未使用的镜像、悬空镜像和容器日志相当好用。也可以在容器页面里给每个容器配置日志轮转限制防止单个容器日志无限膨胀。7. 个人经验几个值得长期坚持的使用习惯文章写到这里安装的路径基本都覆盖到了。最后聊几个我在实际使用中沉淀下来的小习惯算不上什么高深技巧但踩过坑之后确实很庆幸坚持下来了。第一个习惯是安装时永远手动指定面板端口和密码。不要用默认随机值。随机生成的密码我遇到过几次复制错的情况换行符没复制全登录的时候卡了半天。手动指定一个自己熟悉的端口和密码后面所有配置都会省心。第二个习惯是定期做备份恢复演练。1Panel 的备份功能很多人都知道但真正把备份恢复到新服务器上测试过一次的人不多。我建议你每隔一段时间把备份的 tar 包下载到一台临时机器上用 1Panel 的“导入备份”功能恢复一下确认数据完整可用。备份不是拷出来就万事大吉恢复不了等于没有备份。第三个习惯是面板的安全入口尽量保留默认随机值不要为了方便把它删掉。安全入口相当于给面板加了一层路径隐藏即使有人扫到你的端口也要猜中那一长串路径才能看到登录页。这是成本最低的安全防护。还有一个小技巧1Panel 的命令行工具1pctl除了重置密码还能查看面板版本、升级面板、查看服务状态。以后面板网页打不开的时候先跑一遍1pctl status看看服务在不在不要一上来就重启服务器浪费时间。希望这篇安装踩坑记录能帮到你。不管是在 Windows 11 上用 WSL2 练手还是直接上云服务器部署生产环境1Panel 这套面板的上手体验都值得你亲自动手试一试。
