> For the complete documentation index, see [llms.txt](https://xiers-organization.gitbook.io/music-tag-web-v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xiers-organization.gitbook.io/music-tag-web-v2/kuai-su-kai-shi/1panel-bu-shu.md).

# 1panel部署

## 方式一、应用商店安装（推荐）

<figure><img src="/files/zRP6wHgvhZx5fYVbgZAi" alt=""><figcaption></figcaption></figure>

1. 打开 1Pannel 应用商店 - 搜索 Music Tag Web\ <br>

   <figure><img src="/files/3fKVOkcTElb9PStJAhVx" alt=""><figcaption></figcaption></figure>
2. 点击安装即可。\
   默认挂载路径为&#x20;
   * ./data:/app/media:rw&#x20;
   * ./config:/app/data
3. 如需自定义媒体库地址，则编辑 compose 文件修改挂载的地址，例如：

```
<你的媒体库地址>:/app/media:rw 
```

## 方式二、镜像安装

1. 镜像中拉取镜像，仓库名 Docker Hub 镜像名：xhongc/music\_tag\_web:latest

<figure><img src="/files/XpEh9deU1sGzWdWsWAr0" alt=""><figcaption><p>镜像页面</p></figcaption></figure>

<figure><img src="/files/SJMbr8srsLLPoc67fYHO" alt=""><figcaption><p>拉取镜像</p></figcaption></figure>

2. 创建容器，服务器端口可以自己定义你喜欢的端口（第一个值），容器端口必须是 8002（第二个值）不能改变，协议选 TCP 协议\
   \
   挂载设置里，将你的音乐文件映射到/app/media    此路径不可更改。\
   另，新建一个目录存放该项目的配置文件 映射到 /app/data    此路径不可更改。<br>

<figure><img src="/files/eRnU8wdezTmeBFhB9xai" alt=""><figcaption><p>创建容器</p></figcaption></figure>

<figure><img src="/files/VGUF3BUiLeh6kPXzJTX0" alt=""><figcaption><p>容器配置</p></figcaption></figure>

<figure><img src="/files/w96rzb5dWGGPqxDSBNav" alt=""><figcaption><p>部署完成</p></figcaption></figure>

在登录后 点击V1 标签，输入 V2 激活 即可完成激活。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xiers-organization.gitbook.io/music-tag-web-v2/kuai-su-kai-shi/1panel-bu-shu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.