群晖、NAS、PVE、飞牛、二手品牌机、垃圾佬

每一位热爱生活的垃圾佬都值得敬畏

勤奋的凯尔森同学
Rocky Linux

Rocky Linux 10 安装 Webmin 教程

内容目录 Rocky Linux 10 安装Webmin教程 一、教程说明 本教程适配Rocky Linux […]
jason0
内容目录

Rocky Linux 10 安装Webmin教程

一、教程说明

本教程适配Rocky Linux 10系统，解决官方源404、Perl核心模块缺失、IO::Pty模块安装失败、systemd服务识别异常等问题，最终实现Webmin全功能部署（包括依赖IO::Pty的串口管理、Perl脚本执行等小众功能）。

二、前置准备（以root用户执行）

1. 系统更新（避免依赖冲突）

dnf update -y

2. 安装基础工具（编译/下载/网络验证必备）

dnf install -y wget net-tools firewalld gcc make
  • gcc/make：用于CPAN编译安装IO::Pty模块；
  • wget/net-tools：用于下载文件、验证端口监听。

三、安装Perl全量依赖（含IO::Pty模块）

1. 安装系统级Perl核心包（解决Webmin启动基础依赖）

dnf install -y perl-core perl-libs perl-Net-SSLeay perl-CGI perl-Data-Dumper perl-File-Copy-Recursive perl-CPAN

2. 配置CPAN并安装IO::Pty模块（实现Webmin全功能）

# 初始化CPAN（全程按提示输入yes，使用默认配置）
perl -MCPAN -e 'install CPAN; reload CPAN; auto_cleanup(1);'

# 编译+安装IO::Pty模块（系统源未收录，需CPAN手动安装）
perl -MCPAN -e 'install IO::Pty'

3. 验证IO::Pty模块安装（确保生效）

perl -e "use IO::Pty; print 'IO::Pty模块安装成功！\n'"
  • 输出IO::Pty模块安装成功！即验证通过，无报错则代表模块可被Webmin识别。

四、安装最新版Webmin（绕过官方源404问题）

1. 下载Webmin RPM包（SourceForge镜像，稳定不失效）

# 删除残留的无效文件
rm -f /tmp/webmin.rpm

# 下载Webmin 2.111稳定版（官方最新）
wget https://sourceforge.net/projects/webadmin/files/webmin/2.111/webmin-2.111-1.noarch.rpm/download -O /tmp/webmin.rpm

2. 安装Webmin（跳过无关依赖+签名验证）

rpm -ivh /tmp/webmin.rpm --nodeps --nosignature
  • --nodeps：忽略非核心依赖（IO::Pty已通过CPAN安装，此参数仅兼容）；
  • --nosignature：绕过Rocky 10严格的GPG密钥验证（官方包可信）。

五、配置Webmin systemd服务（支持启停/开机自启）

1. 创建webmin.service文件（适配Rocky 10）

vi /etc/systemd/system/webmin.service

粘贴以下内容（路径100%匹配Rocky 10安装环境）：

[Unit]
Description=Webmin Web-based System Administration Tool
After=network.target syslog.target

[Service]
Type=forking
PIDFile=/var/webmin/miniserv.pid
ExecStart=/usr/bin/perl /usr/libexec/webmin/miniserv.pl /etc/webmin/miniserv.conf
ExecStop=/usr/bin/pkill -f /usr/libexec/webmin/miniserv.pl
ExecReload=/usr/bin/pkill -f /usr/libexec/webmin/miniserv.pl && /usr/bin/perl /usr/libexec/webmin/miniserv.pl /etc/webmin/miniserv.conf
Restart=on-failure
RestartSec=5
User=root
Group=root

[Install]
WantedBy=multi-user.target

保存退出（按下Esc → 输入:wq）。

2. 重载systemd并启动Webmin服务

# 重载systemd配置（识别新创建的服务文件）
systemctl daemon-reload

# 启动Webmin并设置开机自启（重启服务器自动运行）
systemctl enable --now webmin

# 验证Webmin服务状态（输出active (running)即成功）
systemctl status webmin

六、配置防火墙（放行Webmin默认端口）

# 永久开放10000端口（Webmin默认访问端口）
firewall-cmd --add-port=10000/tcp --permanent

# 重载防火墙规则（使配置生效）
firewall-cmd --reload

# 验证端口开放状态（输出含10000/tcp即成功）
firewall-cmd --list-ports | grep 10000

七、验证Webmin全功能访问

1. 查看服务器可访问IP

ifconfig
  • 记录输出中的内网IP（示例：192.168.31.106）。

2. 浏览器访问Webmin

https://你的服务器IP:10000/
  • 示例：https://192.168.31.106:10000/
  • 首次访问提示“证书不安全”：点击浏览器「高级」→「继续访问（不安全）」（为自签名证书，不影响功能使用）。

3. 登录验证（使用服务器root账号）

  • 用户名：root
  • 密码：服务器root用户密码
  • 登录后可使用Webmin所有功能（包括依赖IO::Pty的串口管理、Perl脚本执行等）。

八、Webmin常用管理命令

# 启动Webmin
systemctl start webmin

# 停止Webmin
systemctl stop webmin

# 重启Webmin
systemctl restart webmin

# 查看服务状态
systemctl status webmin

# 验证开机自启配置
systemctl is-enabled webmin

九、关键注意事项

  1. 证书配置：Webmin默认使用自签名证书，若需正式SSL证书，可在Webmin界面「Webmin」→「Webmin Configuration」→「SSL Encryption」中配置；
  2. 端口修改：如需修改Webmin访问端口，编辑/etc/webmin/miniserv.conf中的port参数，执行systemctl restart webmin即可生效；
  3. 功能验证：登录Webmin后，可测试「系统」→「串口配置」等依赖IO::Pty的功能，无报错即代表全功能可用；
  4. 开机自启：已通过systemctl enable webmin配置，服务器重启后Webmin会自动运行，无需手动干预。

发表回复