核心功能

远程桌面

• 连接成功后自动打开独立远程窗口并全屏，被控端桌面实时呈现。
• 支持鼠标、键盘完整操作，双击、滚轮、组合键均可用。
• 自动接管控制台会话（原生会话接管，不是简单截屏 + 注入），避免出现黑屏；连接时同步阻止锁屏与熄屏。
• 标题栏只保留关键信息：分辨率 · N FPS。

自适应画质

• 采集端按本机算力与实时帧耗时动态调节画质档位与缩放，帧率不硬性限制，交给带宽和机器性能决定。
• 清晰度优先：普通分辨率屏幕不做降分辨率处理，只在 4K 等高负载场景才收缩画面。
• 低帧率时优先提档而不是降质，避免越卡越糊。

双向文件传输

• 主控端、被控端都支持把文件直接拖到窗口里发送，也支持复制粘贴文件，无需点按钮。
• 多个文件自动排队，同一窗口内显示，不反复弹新窗。
• 专属传输窗：上行 / 下行各一条独立进度条，显示百分比、已传 / 总大小、实时速率、剩余时间；两端都能看到进度。
• 空闲方向不占位，窗口按内容自动伸缩；传输结束 3 秒后自动收起。

剪贴板同步

• 文本剪贴板双向同步，复制即走。

连接方式

• 每台设备有一个由机器码派生的链接码，发给对方即可被控，主控与被控身份按连接方向自动切换。
• 内建穿透隧道，优先尝试 P2P 直连，打不通时自动降级为中继转发，界面上会如实显示当前是「P2P」还是「中继」。
• 隧道逻辑全部内置，不落地任何配置文件或外部辅助程序，点到点即用。

使用流程

1. 双端启动程序，界面显示各自的链接码。
2. 一端输入对方的链接码，点「连接」。
3. 连接成功后被控端画面自动全屏显示，直接开始操作。
4. 需要传文件时，把文件拖进任意窗口即可；传输完成后进度窗自动消失。

其他

• 单主控模式，一台设备同一时间只保持一条会话，避免多人抢占。
• 绿色运行，配置写死在程序内，没有「服务器设置」之类的入口。
• 界面为浅色卡片式布局，品牌色橙 / 绿区分发送与接收方向。
• 适用场景：远程帮同事/家人处理电脑问题、远程办公、跨网络取文件。

本教程使用安装脚本 xg_panel_install.sh，脚本会自动下载并安装面板，注册为 systemd 服务。

一键安装（推荐）

root 下执行一条命令，下载、安装、启动一次完成：

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh install --port 8090 --entrance xgpanel

• --port 8090：面板端口，可改成 8899 等；
• --entrance xgpanel：安全入口，安装完成后访问 http://服务器IP:8090/xgpanel；不写则使用根路径 http://服务器IP:8090/；
• 安装结束会打印实际访问地址、默认账号和密码。

想用默认端口 + 根路径，可用最短的一行：

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh

脚本已是自解压的加密版本，下载后直接 bash 即可，无需 chmod。

一、环境要求

检查架构：

uname -m

脚本按 uname -m 自动选择安装包，对应关系：

下载地址统一为 https://blog.itxiaoguo.xyz/ 加上对应的二进制文件名，例如 https://blog.itxiaoguo.xyz/xg_panel_linux_amd64、https://blog.itxiaoguo.xyz/xg_panel_linux_386，无需手动指定，脚本会自动拼接。

二、获取安装脚本

方式一：服务器直接下载（推荐）

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh
chmod +x /root/xg_panel_install.sh

没有 curl 时可用 wget：
wget -O /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh

方式二：本机上传（在本地电脑执行，把 IP 换成你的服务器）

scp xg_panel_install.sh root@你的服务器IP:/root/

方式三：服务器上直接创建

vi /root/xg_panel_install.sh
# 粘贴脚本内容，保存退出后执行：
chmod +x /root/xg_panel_install.sh

脚本下载地址：https://blog.itxiaoguo.xyz/xg_panel_install.sh

三、安装

1. 默认端口安装

sudo bash /root/xg_panel_install.sh

2. 指定端口安装

sudo bash /root/xg_panel_install.sh install --port 8899

3. 指定端口 + 安全入口安装

sudo bash /root/xg_panel_install.sh install --port 8899 --entrance xgpanel

• --entrance 只能包含字母、数字、下划线、短横线，长度 3–32 位；
• 安装完成后访问 http://服务器IP:8899/xgpanel，不知道入口无法打开面板；
• 不写 --entrance 时使用根路径 http://服务器IP:8899/。

脚本执行流程：

1. 校验 root 权限、CPU 架构（自动匹配 amd64 / 386 / arm / arm64）、systemd；
2. 按架构下载面板程序（如 https://blog.itxiaoguo.xyz/xg_panel_linux_amd64）并校验是否为 ELF 可执行文件；
3. 安装到 /opt/xg-liunxpanel/xg-panel；
4. 写入服务 /etc/systemd/system/xg-panel.service 并设置开机自启；
5. 启动服务并校验运行状态；
6. 指定了 --entrance 时，写入 panel.conf 的 entrance= 并重启服务使之生效；
7. 自动放行 firewalld / ufw 端口；
8. 打印面板地址、默认账号与数据目录。

4. 安装完成后的输出示例

[XG] XG-LiunxPanel 安装完成并已启动
[XG] 已设置安全入口：/xgpanel

  面板地址：http://1.2.3.4:8090/xgpanel
  默认账号：admin
  默认密码：admin123（登录后请立即修改）
  数据目录：/opt/xg-linux
  服务管理：systemctl {status|restart|stop} xg-panel

未设置安全入口时，面板地址显示为 http://1.2.3.4:8090/。

5. 首次登录

浏览器打开输出的面板地址（http://服务器IP:端口/入口），使用 admin / admin123 登录，登录后立即在「设置」中修改密码。

打不开时先检查：安全组是否放行端口 → systemctl status xg-panel → 本机 curl -I http://127.0.0.1:8090。

四、日常管理

1. 查看运行状态

bash /root/xg_panel_install.sh status

输出服务名称、运行状态、程序路径、数据目录、安全入口、访问地址。

2. 常用服务命令

systemctl status xg-panel     # 查看状态
systemctl restart xg-panel    # 重启
systemctl stop xg-panel       # 停止
systemctl start xg-panel      # 启动
systemctl enable xg-panel     # 开机自启
systemctl disable xg-panel    # 取消开机自启

3. 查看日志

journalctl -u xg-panel -n 100 --no-pager      # 最近 100 行
journalctl -u xg-panel -f                     # 实时跟踪

后台安装类任务的日志在面板「任务日志」页面查看，文件位于面板数据目录下。

4. 修改端口

方式一：重新执行安装并指定端口（程序会保留数据）

sudo bash /root/xg_panel_install.sh install --port 8899

方式二：修改配置文件后重启

sed -i 's/^port=.*/port=8899/' /opt/xg-linux/panel.conf
systemctl restart xg-panel

修改后记得在防火墙 / 云安全组放行新端口。

5. 修改安全入口

sed -i 's/^entrance=.*/entrance=myentry/' /opt/xg-linux/panel.conf
systemctl restart xg-panel

• 入口只能包含字母、数字、下划线、短横线，长度 3–32 位；
• 修改后访问 http://服务器IP:端口/myentry，旧入口立即失效；
• 也可以在面板「设置」页面修改，保存后按提示重启服务。

想把入口改回根路径，把该行改成 entrance=（留空）后重启即可。

6. 目录说明

五、更新

sudo bash /root/xg_panel_install.sh update

更新流程：下载新版本 → 备份旧程序为 xg-panel.bak → 停止服务 → 替换程序 → 启动。

如果新版本启动失败，脚本会自动回滚到旧版本并提示查看日志：

journalctl -u xg-panel -n 50 --no-pager

回滚完成后旧程序仍在 /opt/xg-liunxpanel/xg-panel.bak，可手动用于排查。

六、卸载

1. 保留数据卸载（推荐）

sudo bash /root/xg_panel_install.sh uninstall

会停止并删除服务、删除程序目录 /opt/xg-liunxpanel，保留 /opt/xg-linux 中的数据。

2. 彻底卸载（含数据）

sudo bash /root/xg_panel_install.sh uninstall --purge

在上一项基础上再删除 /opt/xg-linux 面板数据。

注意：--purge 只删除面板自身的数据目录。/www 下已创建的网站、数据库、运行环境不会被删除，需要自行清理。

3. 卸载后确认

systemctl status xg-panel        # 应提示 Unit xg-panel.service could not be found
ls /opt/xg-liunxpanel            # 应提示 No such file or directory

七、常见问题

1. 提示 请使用 root 运行

脚本需要 root 权限，使用 sudo bash xg_panel_install.sh ... 执行。

2. 提示 当前架构 xxx 不受支持，仅提供 amd64 / 386 / arm / arm64 安装包

说明 uname -m 的输出不属于下面任一类：x86_64、i386、i686、armv7l、aarch64 等。可先确认架构，再到下载页取对应文件，用 --bin 指定本地文件安装。

3. 提示 下载失败，请检查网络或地址

检查服务器能否访问外网，或先手动验证下载地址（把 amd64 换成实际架构）：

uname -m
curl -I https://blog.itxiaoguo.xyz/xg_panel_linux_amd64

4. 提示 下载失败（HTTP 错误或网络不通） 或 下载内容不是 ELF 可执行文件

先用 curl -I 下载地址 看返回码。若是 404 Not Found，说明这个地址上并没有文件（常见于博客/CDN 把上传文件改成了 /content/uploadfile/... 的随机名）。两种解法：

# 改用真实地址
sudo bash /root/xg_panel_install.sh install --url https://你的真实地址/xg_panel_linux_amd64

# 或先把程序文件上传到服务器，再指定本地文件安装
sudo bash /root/xg_panel_install.sh install --bin /root/xg_panel_linux_amd64

5. 服务启动失败

journalctl -u xg-panel -n 80 --no-pager

常见原因：端口被占用（ss -lnt | grep 8090）、程序无执行权限、磁盘已满。

6. 面板打不开但服务是 active

• 云服务器安全组未放行端口；
• 本机 firewalld / ufw 未放行：脚本会自动尝试，若之前手动关闭过防火墙则需重新放行；
• 浏览器访问的是 https，而面板默认是 http。

7. 忘记登录密码

账号密码保存在 /opt/xg-linux/panel.conf（pass 为哈希值，无法手改）。可删除该配置文件让面板重建默认账号：

systemctl stop xg-panel
cp /opt/xg-linux/panel.conf /opt/xg-linux/panel.conf.bak
rm -f /opt/xg-linux/panel.conf
systemctl start xg-panel

重启后面板会生成新的默认配置，账号恢复为 admin / admin123、端口回到 8090；如需保留原端口，对比备份文件再把 port= 改回去并重启。

8. 设置安全入口后打不开面板

安全入口必须带在地址后面，例如入口为 xgpanel、端口为 8090 时，访问 http://服务器IP:8090/xgpanel。只访问 http://服务器IP:8090/ 会被拒绝，这是正常的安全设计。

忘记入口时执行 bash /root/xg_panel_install.sh status 查看，或直接看配置：

grep '^entrance=' /opt/xg-linux/panel.conf

八、命令速查

# 一键安装（下载 + 安装 + 启动）
curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh

# 下载脚本
curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh

# 安装
sudo bash /root/xg_panel_install.sh
sudo bash /root/xg_panel_install.sh install --port 8899
sudo bash /root/xg_panel_install.sh install --port 8899 --entrance xgpanel

# 状态
bash /root/xg_panel_install.sh status

# 更新
sudo bash /root/xg_panel_install.sh update

# 卸载
sudo bash /root/xg_panel_install.sh uninstall
sudo bash /root/xg_panel_install.sh uninstall --purge

# 服务
systemctl {status|restart|stop|start} xg-panel
journalctl -u xg-panel -n 100 --no-pager

小郭网络长期深耕 Windows 平台技术工具研发，代表性产品包含小郭面板（IIS+MySQL+PHP 一体化建站面板）、小郭音乐播放器等实用工具，受到不少运维、建站爱好者、直播用户的喜爱。本次上线的官方博客网站，将作为产品对外的官方信息出口，统一发布产品更新公告、使用教程、常见问题解答以及项目最新动态。

网站设置产品展示、新闻动态、联系我们等核心板块。在产品展示板块，用户可以快速了解小郭系列工具的产品定位、核心功能与使用场景；新闻动态栏目将持续更新版本发布、功能迭代等资讯；联系我们板块公布了联系电话、邮箱、地址等信息，方便用户反馈问题、提交建议，搭建起开发者与使用者之间沟通桥梁。

“搭建官方博客站点，希望给广大使用者一个正规的信息渠道。过去很多用户通过社群零散获取教程，信息分散。今后产品介绍、新版本通知、操作文档都会优先更新在官网，方便大家查阅。后续我们也会持续丰富网站内容，不断完善文档与教程资源。” 小郭网络负责人表示。

目前网站已完成基础部署，后续会持续扩充技术文章、工具使用案例，优化浏览体验。欢迎广大技术爱好者访问小郭网络博客，体验了解系列自研工具。

网站地址：https://blog.itxiaoguo.xyz/
联系邮箱：982576640@qq.com
论坛地址：https://blog.itxiaoguo.xyz/?plugin=bbs

1. 基础播放功能

• 播放 / 暂停 / 上一首 / 下一首、进度拖拽、音量调节
• 播放模式：列表循环、单曲循环、随机播放
• 歌词窗口：独立悬浮歌词，可置顶、调节字体大小、颜色、透明度（直播 BGM 常用）
• 音频信息读取：自动读取歌曲标题、歌手、专辑、封面图

2. 歌单管理

• 文件夹批量扫描导入（一键扫描整个音乐目录）
• 自建多个歌单，支持拖拽增删歌曲
• 支持保存歌单文件，换环境可以直接导入
• 歌曲列表搜索：按歌名、歌手快速筛选

购买地址https://shop.itxiaoguo.xyz/

[card type="link"]
[activity_countdown title="2026双11特价活动" starttime="2026-10-26 00:00:00" endtime="2026-11-11 23:59:59" style="red" content="活动期间全场商品享4折，数量有限先到先得！"]

【小郭面板】IIS + MySQL + PHP 环境部署介绍

小郭面板是Windows平台、基于IIS的一键建站配置工具，区别于小皮（phpStudy）Nginx/Apache路线；底层原生调用Windows DISM、FastCGI、IIS模块，自动完成IIS开启、PHP-FastCGI绑定、MySQL多实例、伪静态、phpMyAdmin部署，适合Windows Server / Win10/11做PHP站点（WP、织梦、Discuz等）

✅ 系统要求

• 系统：Windows10/11、Windows Server 2016/2019/2022（64位）
• 权限：必须管理员运行面板
• 路径：环境安装目录禁止中文、空格
• 依赖前置：VC++运行库（面板自带检测，缺失自动提示）

🧩 核心组件说明

1. IIS：Windows自带Web服务，面板通过DISM命令一键开启：万维网服务、CGI（FastCGI核心）、静态内容、默认文档、HTTP错误、URL Rewrite重写模块（伪静态必备）、FTP可选安装
2. PHP：采用 NTS非线程安全版（IIS FastCGI标准），支持多PHP版本共存（5.6/7.2/7.4/8.0/8.1），自动配置php.ini、开启mysqli/pdo_mysql/curl/mbstring等扩展，自动注册IIS处理程序映射
3. MySQL：支持5.5/5.6/5.7/8.0，支持多实例独立端口；自动生成my.ini、初始化data目录、注册Windows服务、设置root密码、字符集默认utf8mb4
4. 附加工具：一键部署phpMyAdmin，自动创建IIS站点绑定PHP，图形化管理数据库

📝 完整部署流程（面板内操作顺序）

1. 环境检测

打开面板 → 【环境检测】
自动扫描：IIS状态、CGI、URL重写、VC++、防火墙、已有PHP/MySQL实例，输出检测报告；

防火墙：面板支持一键放行80/443/MySQL端口，或一键关闭（生产不建议直接关）

2. 一键安装IIS组件

点【安装IIS】，底层DISM在线启用角色，自动勾选PHP必须的CGI模块；

如果是精简版系统DISM失败，需要手动在Windows功能里勾选：Internet信息服务 → CGI

3. 安装PHP版本

• 选择PHP版本（推荐7.4通用性最强，8.x新程序）
• 下载源：小郭加速源 / PHP官方源切换
• 面板自动解压、配置php.ini、注册FastCGI映射到IIS，无需手动进IIS管理器添加处理程序映射

4. 安装MySQL实例

• 选择版本、自定义端口（默认3306，多实例必须改端口）
• 设置root密码、字符集、最大连接数
• 自动初始化数据库、注册独立Windows服务，支持同时跑多个MySQL互不冲突
• 面板内功能：启动/停止/重启MySQL、修改root密码、卸载实例

5. 站点管理（IIS网站）

【网站管理】→ 添加站点：

• 填写域名、端口、网站物理目录
• 选择绑定的PHP版本（多PHP隔离）
• 一键导入IIS伪静态规则（WP、Discuz、织梦预设）
• 自动配置默认文档：index.php、index.html

6. 数据库管理

面板内置库管理：

• 创建数据库 + 独立数据库账号（不直接用root给网站）
• 改字符集、删除库、导出SQL备份
• 【phpMyAdmin一键部署】：选择PHP版本+访问端口，自动生成独立IIS站点，直接浏览器访问管理数据库

7. 测试环境

站点目录新建 info.php

<?php phpinfo(); ?>

浏览器访问 http://你的域名/info.php，页面正常打开、能看到mysql扩展 = PHP+IIS联动成功；
phpMyAdmin登录验证MySQL账号密码连通性。

⚙️ 面板自带优势（对比手动配IIS+PHP）

• 不用手动打开IIS管理器、不用手动加FastCGI映射、不用手写web.config伪静态
• MySQL多实例友好，不同网站可以隔离数据库实例
• 统一记录账号密码在本地配置文件，防止遗忘
• 一键启停整套环境、站点、数据库服务
• 适配Windows权限，自动处理目录读写权限（PHP上传缓存目录）

⚠️ 重点坑与注意事项

1. IIS + PHP 必须用 NTS（非线程安全）PHP，TS版本IIS FastCGI会异常，面板下载包已经过滤，不要自己替换TS包
2. MySQL8.0默认密码认证插件caching_sha2_password，老PHP版本（5.6/7.0）连不上，需要在面板创建账号时选择传统mysql_native_password
3. URL重写模块是伪静态关键，DISM安装失败就手动去iis.net下载rewrite2.1安装包
4. 服务器外网访问：安全组放行80/443，MySQL端口不要对公网开放
5. 该面板只管理原生IIS，和Nginx、小皮面板环境冲突，一台机器不要混装两套PHP环境
6. 属于第三方个人工具，非微软官方面板，适合自用、开发、小规模站点，高并发生产环境需要自行做安全加固

🆚 和小皮phpStudy简单区别

🔧 常见故障快速排查

1. 访问php页面404：IIS没识别php，重新在面板绑定PHP版本，重启IIS
2. 500错误：php.ini缺少扩展、目录权限不足、伪静态规则写错
3. PHP连不上MySQL：版本密码插件不兼容、MySQL服务未启动、防火墙拦截端口

1. 隧道协议：TCP / UDP / HTTP / HTTPS，支持远程桌面 RDP、SSH、NAS、网站调试、游戏联机、本地接口回调、数据库转发等场景
2. 客户端：Windows 为主（易语言写的，杀毒容易误报），轻量单文件，一键加载配置，后台驻留保活、断线自动重连
3. 域名：自带分配二级域名，也支持绑定自己备案域名、HTTPS 证书
4. 管理：网页面板增删隧道、查看在线状态、流量统计、连接日志、在线控隧道启停
5. 底层优化（V3 对比 V2 升级点）
   • 多路复用，单连接承载多条隧道，减少握手开销、弱网更稳
   • 传输加密，流量中转加密
   • 连接保活机制优化，NAT 环境（家用宽带、4G）掉线重连更快
   • 面板交互改版，隧道配置实时生效，不用重启客户端

✅ 适用场景

• 开发：本地 Web、公众号 / 小程序接口调试
• 内网设备：群晖 / 绿联 NAS、监控、软路由、打印机外网访问
• 远程运维：Windows 远程桌面、Linux SSH
• UDP 场景：游戏联机、DNS、IPTV、软路由 UDP 转发

购买地址https://shop.itxiaoguo.xyz/

[card type="link"]
[activity_countdown title="2026双11特价活动" starttime="2026-10-26 00:00:00" endtime="2026-11-11 23:59:59" style="red" content="活动期间全场商品享4折，数量有限先到先得！"]