diff --git a/docs/issues/index.md b/docs/issues/index.md
index b34f065..4a80e57 100644
--- a/docs/issues/index.md
+++ b/docs/issues/index.md
@@ -180,6 +180,41 @@ pdm run xiaomusic.py
 如果是开发前端界面，可以通过 <http://localhost:8090/docs>
 查看有什么接口。目前的 web 控制台非常简陋，欢迎有兴趣的朋友帮忙实现一个漂亮的前端，需要什么接口可以随时提需求。
 
+## 1Panel 安装运行
+
+本教程将指导您如何在 1Panel 面板中安装和配置 XiaoMusic。
+
+### 前提条件
+
+在开始安装前，请确保您已完成以下准备工作：
+
+- 已安装并运行 1Panel 面板
+
+如需详细安装 1Panel 面板，请参考 [1Panel 官方安装文档](https://1panel.cn/docs/v2/installation/online_installation/)
+
+安装完成后，通过提示的**访问地址**和**初始账号密码**登录 1Panel。
+
+### 安装 XiaoMusic
+
+登录 1Panel，进入 **应用商店**，搜索 **xiaomusic**，点击**安装**即可。
+
+#### 配置参数说明
+
+安装时请根据实际需求配置以下参数：
+
+- **高级设置**：根据实际需要勾选**端口外部访问**，勾选后即可通过外部 IP 访问 XiaoMusic。
+
+> 保持**默认配置**也可以完成安装，但建议根据实际需求调整。
+
+### 访问 XiaoMusic
+
+安装完成后，进入 1Panel 的 **已安装** 页面，点击 **跳转** 即可进入 XiaoMusic 的 **WebUI** 页面。
+
+> 使用前建议在 **面板设置** 页面设置好**默认访问地址**。
+
+> 如果后续配置了**反向代理**，可以在 `已安装 → 参数` 页面修改 **Web 访问地址**。
+
+
 ### 🚦 代码提交规范
 
 提交前请执行