biss/blog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
01b5e2e1baf9630484631bb89a109e855f2bd2ac
blog/posts/bb18d851/index.html
T
biss 01b5e2e1ba Merge pull request '更换到Astro' (#9) from switch-to-astro into master 
Reviewed-on: #9
 -- [CST 2026-06-19 Friday 13:28:19]
2026-06-19 13:28:19 +08:00

1087 lines
98 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html><html lang="zh-CN"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="description" content="这篇文章详细介绍了如何为1Panel添加自定义应用的过程，包括预准备工作、创建文件和配置应用声明文件等步骤。首先，作者强调了Fork仓库和创建新分支的重要性。接着，文章逐步讲解了如何在应用目录下创建所需的文件和子目录，如halo、logo.png、data.yml、README.md等。特别详细地说明了应用声明文件data.yml的构成，包括基本信息、应用标签、类型等关键配置。此外，还解释了关于端口字段和type字段的具体使用方法，提供了实际安装时填写form表单的示例。整个过程不仅清晰易懂，而且为开发者提供了一套完整的操作指南，有助于他们更好地理解和实施应用添加到1Panel的过程。"><link rel="icon" href="/images/Bi.ico"><script defer src="https://umami.biss.click/script.js" data-website-id="3d97b310-b241-4fc6-bc9c-68e317fc7d42"></script><script>window.SITE_CONFIG = {"site":{"url":"https://blog.biss.click","name":"Bi's Blog","description":"Personal blog by biss.","language":"zh-CN","domain":"blog.biss.click","slogan":"好奇心转化为代码的空间。","startTime":"2025-01-01T00:00:00+08:00","copyrightStartYear":2025,"license":"内容采用 CC BY-NC-SA 4.0 协议"},"author":{"name":"biss","email":"bishsh2006@gmail.com","github":"https://github.com/bishshi","avatar":"https://free.picui.cn/free/2025/08/10/689845496a283.png"},"comments":{"envId":"https://comment.biss.click","region":"","script":"https://cdn.jsdelivr.net/npm/twikoo@1.7.7/dist/twikoo.min.js"},"analytics":{"umami":{"script":"https://umami.biss.click/script.js","websiteId":"3d97b310-b241-4fc6-bc9c-68e317fc7d42","statsEndpoint":"https://blogumami.biss.click"}},"talks":{"apiUrl":"https://mm.biss.click/api/echo/page","pageSize":30,"homeLimit":6,"cacheKey":"talksCache","cacheTimeKey":"talksCacheTime","cacheDurationMs":1800000,"fallbackAvatar":"https://free.picui.cn/free/2025/08/10/689845496a283.png"},"search":{"apiKey":"2uxQzk7eD2GBCljdSmIiuU3ause7UK9n","server":{"host":"typesense.biss.click","port":"443","protocol":"https"},"indexName":"blogs","searchParams":{"query_by":"title,content","highlight_full_fields":"title,content","per_page":8,"num_typos":1,"typo_tokens_threshold":1,"prefix":true},"ui":{"maxRetries":10,"retryDelay":100,"animationDuration":300,"maxInitRetries":30,"placeholder":"输入关键词寻找故事..."}},"externalLinks":{"waitSeconds":10,"whitelist":["blog.biss.click","biss.click","github.com","localhost","127.0.0.1"]}};</script><script>
(() => {
const storageKey = 'site-theme';
const savedTheme = localStorage.getItem(storageKey);
const systemTheme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
document.documentElement.dataset.theme = savedTheme || systemTheme;
})();
</script><link rel="stylesheet" href="https://cdn.jsdmirror.com/npm/instantsearch.css/themes/reset-min.css"><link rel="stylesheet" href="https://cdn.jsdmirror.com/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.css"><link rel="stylesheet" href="https://cdn.jsdmirror.com/npm/@fortawesome/fontawesome-free@6.7.2/css/all.min.css"><title>为1Panel添加自己想要的应用 | Bi&#39;s Blog</title><link rel="stylesheet" href="/_astro/BaseLayout.D7kFxpxP.css"></head> <body> <header class="site-header"> <nav class="nav"> <a class="brand" href="/">Bi&#39;s Blog</a> <button class="nav-menu-toggle" type="button" aria-label="打开菜单" aria-expanded="false" data-nav-toggle> <i class="fa-solid fa-bars nav-menu-open" aria-hidden="true"></i> <i class="fa-solid fa-xmark nav-menu-close" aria-hidden="true"></i> </button> <div class="nav-menu" data-nav-menu> <div class="nav-links nav-center"> <a href="/archives/"><i class="fa-solid fa-box-archive nav-icon" aria-hidden="true"></i><span>归档</span></a><a href="/categories/"><i class="fa-solid fa-folder-open nav-icon" aria-hidden="true"></i><span>分类</span></a><a href="/tags/"><i class="fa-solid fa-tags nav-icon" aria-hidden="true"></i><span>标签</span></a><a href="/shuoshuo/"><i class="fa-regular fa-comments nav-icon" aria-hidden="true"></i><span>说说</span></a><a href="/about/"><i class="fa-solid fa-heart nav-icon" aria-hidden="true"></i><span>关于</span></a><a href="/link/"><i class="fa-solid fa-link nav-icon" aria-hidden="true"></i><span>友链</span></a> </div> <div class="nav-links nav-actions"> <button class="nav-random" type="button" onclick="randomPost()" aria-label="前往随机文章" title="前往随机文章"> <i class="fa-solid fa-shuffle nav-icon" aria-hidden="true"></i> <span>随机文章</span> </button> <button class="nav-search search-typesense-trigger" type="button" aria-label="搜索" title="搜索"> <i class="fa-solid fa-magnifying-glass nav-icon" aria-hidden="true"></i> <span>搜索</span> </button> <button class="theme-toggle" type="button" aria-label="切换夜间模式" title="切换夜间模式" data-theme-toggle> <i class="fa-solid fa-sun theme-toggle-sun nav-icon" aria-hidden="true"></i> <i class="fa-solid fa-moon theme-toggle-moon nav-icon" aria-hidden="true"></i> </button> </div> </div> </nav> </header> <main> <section class="post-layout"> <article class="article post-article"> <header class="article-header article-header-cover"> <img class="article-header-cover-img" src="https://pic.biss.click/image/fa0178dd-b1f6-48eb-8690-42faf26c9f52.webp" alt="" loading="eager" decoding="async"> <div class="article-header-content"> <time datetime="2025-08-19T10:43:16.000Z">2025/08/19</time> <h1>为1Panel添加自己想要的应用</h1> <div class="article-hero-meta" aria-label="文章信息"> <span>发布于 2025/08/19</span> <a href="/categories/tech/">技术</a> <span>总字数：1.5k</span> <span>阅读时长：4 分钟</span> </div> </div> </header> <section class="article-summary-card" aria-label="AI 文章摘要"> <div class="article-summary-dots" aria-hidden="true"> <span></span> <span></span> <span></span> </div> <p class="article-summary-content"> <span class="article-summary-text" data-summary-text="这篇文章详细介绍了如何为1Panel添加自定义应用的过程，包括预准备工作、创建文件和配置应用声明文件等步骤。首先，作者强调了Fork仓库和创建新分支的重要性。接着，文章逐步讲解了如何在应用目录下创建所需的文件和子目录，如halo、logo.png、data.yml、README.md等。特别详细地说明了应用声明文件data.yml的构成，包括基本信息、应用标签、类型等关键配置。此外，还解释了关于端口字段和type字段的具体使用方法，提供了实际安装时填写form表单的示例。整个过程不仅清晰易懂，而且为开发者提供了一套完整的操作指南，有助于他们更好地理解和实施应用添加到1Panel的过程。">这篇文章详细介绍了如何为1Panel添加自定义应用的过程，包括预准备工作、创建文件和配置应用声明文件等步骤。首先，作者强调了Fork仓库和创建新分支的重要性。接着，文章逐步讲解了如何在应用目录下创建所需的文件和子目录，如halo、logo.png、data.yml、README.md等。特别详细地说明了应用声明文件data.yml的构成，包括基本信息、应用标签、类型等关键配置。此外，还解释了关于端口字段和type字段的具体使用方法，提供了实际安装时填写form表单的示例。整个过程不仅清晰易懂，而且为开发者提供了一套完整的操作指南，有助于他们更好地理解和实施应用添加到1Panel的过程。</span> <span class="article-summary-caret" aria-hidden="true"></span> </p> <div class="article-summary-footer"> <span class="article-summary-brand"> <span aria-hidden="true">✣</span>
AI摘要
</span> <span class="article-summary-model">QWEN</span> </div> </section> <div class="prose" data-toc="[{&quot;depth&quot;:1,&quot;text&quot;:&quot;预准备&quot;,&quot;id&quot;:&quot;预准备&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;创建文件&quot;,&quot;id&quot;:&quot;创建文件&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;文件目录&quot;,&quot;id&quot;:&quot;文件目录&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;应用声明文件`data.yml`&quot;,&quot;id&quot;:&quot;应用声明文件datayml&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;应用标签 - tags 字段&quot;,&quot;id&quot;:&quot;应用标签-tags-字段&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;应用类型 - type 字段&quot;,&quot;id&quot;:&quot;应用类型-type-字段&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;应用参数配置文件 data.yml&quot;,&quot;id&quot;:&quot;应用参数配置文件-datayml&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;关于端口字段：&quot;,&quot;id&quot;:&quot;关于端口字段&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;关于 type 字段：&quot;,&quot;id&quot;:&quot;关于-type-字段&quot;},{&quot;depth&quot;:2,&quot;text&quot;:&quot;脚本&quot;,&quot;id&quot;:&quot;脚本&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;本地测试&quot;,&quot;id&quot;:&quot;本地测试&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;提交文件&quot;,&quot;id&quot;:&quot;提交文件&quot;},{&quot;depth&quot;:1,&quot;text&quot;:&quot;提交 Pull Request&quot;,&quot;id&quot;:&quot;提交-pull-request&quot;}]"> <p>记录一下自己为1Panel贡献自己应用的经历</p>
<h1 id="预准备">预准备</h1>
<ol>
<li>
Fork仓库
<a class="hexo-link-card" href="https://github.com/1Panel-dev/appstore" target="_blank" rel="external nofollow noopener noreferrer">
<span class="hexo-link-card__icon" aria-hidden="true">1</span>
<span class="hexo-link-card__body">
<strong>1Panel appstore 仓库</strong>
<span>1panel appstore · github.com</span>
</span>
</a>
把仓库fork到自己的仓库
</li>
<li>pull
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#B392F0">git</span><span style="color:#9ECBFF"> clone</span><span style="color:#79B8FF"> -b</span><span style="color:#9ECBFF"> dev</span><span style="color:#9ECBFF"> https://</span><span style="color:#F97583">&#x3C;</span><span style="color:#9ECBFF">your-github-usernam</span><span style="color:#E1E4E8">e</span><span style="color:#F97583">></span><span style="color:#9ECBFF">/appstore</span></span></code></pre>
创建新分支
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#79B8FF">cd</span><span style="color:#9ECBFF"> appstore</span></span>
<span class="line"><span style="color:#B392F0">git</span><span style="color:#9ECBFF"> checkout</span><span style="color:#79B8FF"> -b</span><span style="color:#9ECBFF"> app/</span><span style="color:#F97583">&#x3C;</span><span style="color:#9ECBFF">app-nam</span><span style="color:#E1E4E8">e</span><span style="color:#F97583">></span></span></code></pre>
</li>
</ol>
<h1 id="创建文件">创建文件</h1>
<h2 id="文件目录">文件目录</h2>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="plaintext"><code><span class="line"><span>├──halo // 以 halo 的 key 命名 ，下面解释什么是 key </span></span>
<span class="line"><span> ├── logo.png // 应用 logo , 最好是 180 * 180 px 不要超过 10 KB </span></span>
<span class="line"><span> ├── data.yml // 应用声明文件</span></span>
<span class="line"><span> ├── README.md // 应用的 README</span></span>
<span class="line"><span> ├── 2.2.0 // 应用版本 注意不要以 v 开头</span></span>
<span class="line"><span> │   ├── data.yml // 应用的参数配置，下面有详细介绍</span></span>
<span class="line"><span> │   ├── data // 挂载出来的目录 </span></span>
<span class="line"><span> | ├── scripts // 脚本目录 存放 init.sh upgrade.sh uninstall.sh</span></span>
<span class="line"><span> │   └── docker-compose.yml // docker-compose 文件</span></span>
<span class="line"><span> └── 2.3.2</span></span>
<span class="line"><span> ├── data.yml</span></span>
<span class="line"><span> ├── data</span></span>
<span class="line"><span> └── docker-compose.yml</span></span></code></pre>
<h2 id="应用声明文件datayml">应用声明文件<code>data.yml</code></h2>
<p>本文件主要用于声明应用的一些信息</p>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="yml"><code><span class="line"><span style="color:#85E89D">additionalProperties</span><span style="color:#E1E4E8">: </span><span style="color:#6A737D">#固定参数</span></span>
<span class="line"><span style="color:#85E89D"> key</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">halo</span><span style="color:#6A737D"> #应用的 key ，仅限英文，用于在 Linux 创建文件夹</span></span>
<span class="line"><span style="color:#85E89D"> name</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Halo</span><span style="color:#6A737D"> #应用名称</span></span>
<span class="line"><span style="color:#85E89D"> tags</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">WebSite</span><span style="color:#6A737D"> #应用标签，可以有多个，请参照下方的标签列表 </span></span>
<span class="line"><span style="color:#85E89D"> description</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Powerful and easy-to-use open source website builder</span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">强大易用的开源建站工具</span><span style="color:#6A737D"> #应用中文描述，不要超过30个字</span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">:</span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">website</span><span style="color:#6A737D"> #应用类型，区别于应用分类，只能有一个，请参照下方的类型列表</span></span>
<span class="line"><span style="color:#85E89D"> crossVersionUpdate</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#6A737D"> #是否可以跨大版本升级</span></span>
<span class="line"><span style="color:#85E89D"> limit</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">0</span><span style="color:#6A737D"> #应用安装数量限制，0 代表无限制</span></span>
<span class="line"><span style="color:#85E89D"> website</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">https://halo.run/</span><span style="color:#6A737D"> #官网地址</span></span>
<span class="line"><span style="color:#85E89D"> github</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">https://github.com/halo-dev/halo</span><span style="color:#6A737D"> #github 地址 </span></span>
<span class="line"><span style="color:#85E89D"> document</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">https://docs.halo.run/</span><span style="color:#6A737D"> #文档地址</span></span></code></pre>
<h2 id="应用标签---tags-字段">应用标签 - tags 字段</h2>
<table><thead><tr><th>key</th><th>name</th></tr></thead><tbody><tr><td>WebSite</td><td>建站</td></tr><tr><td>Server</td><td>Web 服务器</td></tr><tr><td>Runtime</td><td>运行环境</td></tr><tr><td>Database</td><td>数据库</td></tr><tr><td>Tool</td><td>工具</td></tr><tr><td>CI/CD</td><td>CI/CD</td></tr><tr><td>Local</td><td>本地</td></tr></tbody></table>
<h1 id="应用类型---type-字段">应用类型 - type 字段</h1>
<table><thead><tr><th>type</th><th>说明</th></tr></thead><tbody><tr><td>website</td><td>website 类型在 1Panel 中支持在网站中一键部署,wordpress halo 都是此 type</td></tr><tr><td>runtime</td><td>mysql openresty redis 等类型的应用</td></tr><tr><td>tool</td><td>phpMyAdmin redis-commander jenkins 等类型的应用</td></tr></tbody></table>
<h1 id="应用参数配置文件-datayml">应用参数配置文件 data.yml</h1>
<p>（注意区分于应用主目录下面的 <code>data.yaml</code>）</p>
<p>本文件主要用于生成安装时要填写的 form 表单，在应用版本文件夹下面 可以无表单，但是需要有这个 data.yml文件，并且包含 formFields 字段</p>
<p>以安装 halo 时的 form 表单 为例</p>
<p>如果要生成上面的表单，需要这么填写 <code>data.yml</code></p>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="yml"><code><span class="line"><span style="color:#85E89D"> additionalProperties</span><span style="color:#E1E4E8">: </span><span style="color:#6A737D">#固定参数</span></span>
<span class="line"><span style="color:#85E89D"> formFields</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">""</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_HOST</span><span style="color:#6A737D"> #docker-compose 文件中的参数</span></span>
<span class="line"><span style="color:#85E89D"> key</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">mysql</span><span style="color:#6A737D"> #依赖应用的 key , 例如 mysql</span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database Service</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">データベースサービス</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Perkhidmatan Pangkalan Data</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Serviço de Banco de Dados</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Сервис базы данных</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">데이터베이스 서비스</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库服务</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">數據庫 服務</span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#6A737D"> #是否必填</span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">service</span><span style="color:#6A737D"> #如果需要依赖其他应用，例如数据库，使用此 type </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">halo</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_NAME</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">データベース</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Pangkalan Data</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Banco de Dados</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">База данных</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">데이터베이스</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库名</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫名稱</span></span>
<span class="line"><span style="color:#85E89D"> random</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#6A737D"> #是否在 default 文字后面，增加随机字符串</span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramCommon</span><span style="color:#6A737D"> #校验规则</span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">text</span><span style="color:#6A737D"> #需要手动填写的，使用此 type</span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">halo</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_USER</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">User</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">ユーザー</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Pengguna</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Usuário</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Пользователь</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">사용자</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库用户</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫使用者</span></span>
<span class="line"><span style="color:#85E89D"> random</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramCommon</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">text</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">halo</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_USER_PASSWORD</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Password</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">パスワード</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Kata laluan</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Senha</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Пароль</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">비밀번호</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库用户密码</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫使用者密碼</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> random</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramComplexity</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">password</span><span style="color:#6A737D"> #密码字段使用此 type</span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">admin</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">HALO_ADMIN</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> labelEn</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Admin Username</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> labelZh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">超级管理员用户名</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramCommon</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">text</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">http://localhost:8080</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> edit</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">HALO_EXTERNAL_URL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">External URL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">外部URL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">URL Luaran</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">URL Externa</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Внешний URL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">외부 URL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">外部访问地址</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">外部訪問地址</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramExtUrl</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">text</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">8080</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> edit</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_APP_PORT_HTTP</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Port</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">ポート</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Port</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Porta</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Порт</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">포트</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">端口</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">埠</span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> rule</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">paramPort</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">number</span><span style="color:#6A737D"> #端口使用此 type </span></span></code></pre>
<h2 id="关于端口字段">关于端口字段：</h2>
<p><code>PANEL_APP_PORT_HTTP</code> 有 <code>web</code> 访问端口的优先使用此 <code>envKey</code>
<code>envKey</code> 中包含 <code>PANEL_APP_PORT</code> 前缀会被认定为端口类型，并且用于安装前的端口占用校验。注意：端口需要是外部端口</p>
<h2 id="关于-type-字段">关于 type 字段：</h2>
<table><thead><tr><th>type</th><th>说明</th></tr></thead><tbody><tr><td>service</td><td>type: service 如果该应用需要依赖其他组件，如 mysql redis 等，可以通过 key: mysql 定义依赖的名称，在创建应用时会要求先创建依赖的应用。</td></tr><tr><td>password</td><td>type: password 敏感信息，如密码相关的字段会默认不显示明文。</td></tr><tr><td>text</td><td>type: text 一般内容，比如数据库名称，默认明文显示。</td></tr><tr><td>number</td><td>type: number 一般用在端口相关的配置上，只允许输入数字。</td></tr></tbody></table>
<p>简单的例子</p>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="yml"><code><span class="line"><span style="color:#6A737D"># type: service，定义一个 mysql 的 service 依赖。</span></span>
<span class="line"><span style="color:#E1E4E8">- </span><span style="color:#85E89D">child</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">""</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_HOST</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">service</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">mysql</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_TYPE</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database Service</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">データベースサービス</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Perkhidmatan Pangkalan Data</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Serviço de Banco de Dados</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Сервис баз данных</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">데이터베이스 서비스</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫服務</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库服务</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">apps</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> values</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">MySQL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">mysql</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">MariaDB</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">mariadb</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A737D"># type: password</span></span>
<span class="line"><span style="color:#E1E4E8">- </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">word</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">PANEL_DB_USER_PASSWORD</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> labelEn</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database Password</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> labelZh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库密码</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database Password</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">データベースのパスワード</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Kata Laluan Pangkalan Data</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Senha do Banco de Dados</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Пароль базы данных</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">데이터베이스 비밀번호</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫密碼</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库密码</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> random</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">password</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A737D"># type: text</span></span>
<span class="line"><span style="color:#E1E4E8">- </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">""</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> edit</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">REDIS_HOST</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> key</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">redis</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">service</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Redis Service</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Redis サービス</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Perkhidmatan Redis</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Serviço Redis</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Сервис Redis</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Redis 서비스</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-Hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Redis 服務</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Redis 服务</span></span>
<span class="line"><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#6A737D"># type: number</span></span>
<span class="line"><span style="color:#E1E4E8">- </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">""</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> edit</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">DBHUB_DB_PORT</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">text</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> label</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> en</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Database Port</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ja</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">データベースのポート</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ms</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Pangkalan Data Port</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> pt-br</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Porta do Banco de Dados</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ru</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">Порт базы данных</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ko</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">데이터베이스 포트</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh-hant</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">資料庫端口</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> zh</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">数据库端口</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A737D"># type: select</span></span>
<span class="line"><span style="color:#E1E4E8">- </span><span style="color:#85E89D">default</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"ERROR"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> envKey</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">LOG_LEVEL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> required</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> type</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">select</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> values</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">DEBUG</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"DEBUG"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">INFO</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"INFO"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">WARNING</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"WARNING"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">ERROR</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"ERROR"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#85E89D">label</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">CRITICAL</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> value</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"CRITICAL"</span></span></code></pre>
<p>rule 字段目前支持的几种校验</p>
<table><thead><tr><th>rule</th><th>规则</th></tr></thead><tbody><tr><td>paramPort</td><td>用于限制端口范围为 1-65535</td></tr><tr><td>paramExtUrl</td><td>格式为 http(s)://(域名/ip):(端口)</td></tr><tr><td>paramCommon</td><td>英文、数字、.-和_,长度2-30</td></tr><tr><td>paramComplexity</td><td>支持英文、数字、.%@$!&#x26;~_-,长度6-30，特殊字符不能在首尾</td></tr></tbody></table>
<p>应用 <code>docker-compose.yml</code> 文件</p>
<p><code>${PANEL_APP_PORT_HTTP} </code>类型的参数，都在 <code>data.yml</code> 中有声明</p>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="yml"><code><span class="line"><span style="color:#85E89D">version</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"3"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D">services</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> halo</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> image</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">halohub/halo:2.2.0</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> container_name</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">${CONTAINER_NAME} // 固定写法，勿改</span></span>
<span class="line"><span style="color:#85E89D"> restart</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">always</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> networks</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">1panel-network // 1Panel 创建的应用都在此网络下</span></span>
<span class="line"><span style="color:#85E89D"> volumes</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">./data:/root/.halo2</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> ports</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">${PANEL_APP_PORT_HTTP}:8090</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> command</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--spring.r2dbc.url=r2dbc:pool:${HALO_PLATFORM}://${PANEL_DB_HOST}:${HALO_DB_PORT}/${PANEL_DB_NAME}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--spring.r2dbc.username=${PANEL_DB_USER}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--spring.r2dbc.password=${PANEL_DB_USER_PASSWORD}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--spring.sql.init.platform=${HALO_PLATFORM}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--halo.external-url=${HALO_EXTERNAL_URL}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--halo.security.initializer.superadminusername=${HALO_ADMIN}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> - </span><span style="color:#9ECBFF">--halo.security.initializer.superadminpassword=${HALO_ADMIN_PASSWORD}</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D"> labels</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> createdBy</span><span style="color:#E1E4E8">: </span><span style="color:#9ECBFF">"Apps"</span><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#E1E4E8"> </span></span>
<span class="line"><span style="color:#85E89D">networks</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> 1panel-network</span><span style="color:#E1E4E8">: </span></span>
<span class="line"><span style="color:#85E89D"> external</span><span style="color:#E1E4E8">: </span><span style="color:#79B8FF">true</span></span></code></pre>
<h2 id="脚本">脚本</h2>
<p>1Panel 在 安装之前、升级之前、卸载之后支持执行 .sh 脚本
分别对应 init.sh upgrade.sh uninstall.sh
存放目录(以halo为例) : halo/2.2.0/scripts</p>
<h1 id="本地测试">本地测试</h1>
<p>将应用目录上传到 1Panel 的 /opt/1panel/resource/apps/local 文件夹下
注意：/opt 为 1Panel 默认安装目录，请根据自己的实际情况修改
上传完成后，目录结构如下</p>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="plaintext"><code><span class="line"><span>├──halo </span></span>
<span class="line"><span> ├── logo.png </span></span>
<span class="line"><span> ├── data.yml</span></span>
<span class="line"><span> ├── README.md </span></span>
<span class="line"><span> ├── 2.2.0 </span></span>
<span class="line"><span> ├── data.yml </span></span>
<span class="line"><span> ├── data </span></span>
<span class="line"><span> └── docker-compose.yml</span></span></code></pre>
<p>在 1Panel 应用商店中，点击更新应用列表按钮同步本地应用</p>
<p>v1.2 版本及之前版本的本地应用，请参考这个文档修改</p>
<h1 id="提交文件">提交文件</h1>
<pre class="astro-code github-dark" style="background-color:#24292e;color:#e1e4e8; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#B392F0">git</span><span style="color:#9ECBFF"> add</span><span style="color:#9ECBFF"> .</span></span>
<span class="line"><span style="color:#B392F0">git</span><span style="color:#9ECBFF"> commit</span><span style="color:#79B8FF"> -m</span><span style="color:#9ECBFF"> "Add my-app"</span></span>
<span class="line"><span style="color:#B392F0">git</span><span style="color:#9ECBFF"> push</span><span style="color:#9ECBFF"> origin</span><span style="color:#9ECBFF"> dev</span></span></code></pre>
<h1 id="提交-pull-request">提交 Pull Request</h1>
<p>在你的仓库点击 Pull requests 菜单
点击 New pull request ，填写标题和描述
选择由你的分支提交到 1Panel-dev/appstore</p> </div> <section class="post-copyright-card" aria-label="文章版权信息"> <div class="post-copyright-mark" aria-hidden="true"> <span>CC</span> </div> <div class="post-copyright-main"> <h2>为1Panel添加自己想要的应用</h2> <a class="post-copyright-link" href="/posts/bb18d851/">/posts/bb18d851/</a> <dl class="post-copyright-meta"> <div> <dt>作者</dt> <dd>biss</dd> </div> <div> <dt>发布于</dt> <dd><time datetime="2025-08-19T10:43:16.000Z">2025/08/19</time></dd> </div> <div> <dt>许可协议</dt> <dd><a href="https://creativecommons.org/licenses/by-nc-sa/4.0/" target="_blank" rel="noreferrer">CC BY-NC-SA 4.0</a></dd> </div> </dl> </div> <div class="post-copyright-footer"> <div class="post-copyright-tags" aria-label="文章标签"> <a href="/tags/1panel/">1panel</a> </div> <div class="post-copyright-actions" aria-label="文章操作"> <button class="post-copyright-action is-primary post-share-button" type="button" data-share-title="为1Panel添加自己想要的应用" data-share-url="https://blog.biss.click/posts/bb18d851/" title="分享文章"> <svg aria-hidden="true" viewBox="0 0 24 24"> <path d="M4 12v7a1 1 0 0 0 1 1h14a1 1 0 0 0 1-1v-7"></path> <path d="M12 16V4"></path> <path d="m7 9 5-5 5 5"></path> </svg> <span>分享</span> </button> <a class="post-copyright-action" href="/rss.xml" title="订阅 RSS"> <svg aria-hidden="true" viewBox="0 0 24 24"> <path d="M5 5a14 14 0 0 1 14 14"></path> <path d="M5 11a8 8 0 0 1 8 8"></path> <path d="M6 18h.01"></path> </svg> <span>订阅</span> </a> <a class="post-copyright-action" href="/about/" title="打赏作者"> <svg aria-hidden="true" viewBox="0 0 24 24"> <path d="M7 8h10"></path> <path d="M8 8V5h8v3"></path> <path d="M6 8h12l-1.5 11h-9L6 8Z"></path> <path d="M10 12h4"></path> </svg> <span>打赏</span> </a> <a class="post-copyright-icon" href="https://twitter.com/intent/tweet?url=https%3A%2F%2Fblog.biss.click%2Fposts%2Fbb18d851%2F&amp;text=%E4%B8%BA1Panel%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%B7%B1%E6%83%B3%E8%A6%81%E7%9A%84%E5%BA%94%E7%94%A8" target="_blank" rel="noreferrer" title="分享到 X"> <span aria-hidden="true">x</span> </a> <a class="post-copyright-icon" href="https://service.weibo.com/share/share.php?url=https%3A%2F%2Fblog.biss.click%2Fposts%2Fbb18d851%2F&amp;title=%E4%B8%BA1Panel%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%B7%B1%E6%83%B3%E8%A6%81%E7%9A%84%E5%BA%94%E7%94%A8" target="_blank" rel="noreferrer" title="分享到微博"> <span aria-hidden="true">微</span> </a> </div> </div> </section> <script>
(() => {
document.querySelectorAll('.post-share-button').forEach((button) => {
button.addEventListener('click', async () => {
const title = button.dataset.shareTitle || document.title;
const url = button.dataset.shareUrl || window.location.href;
const label = button.querySelector('span');
const originalText = label?.textContent || '分享';
try {
if (navigator.share) {
await navigator.share({ title, url });
return;
}
await navigator.clipboard.writeText(url);
if (label) label.textContent = '已复制';
} catch {
if (label) label.textContent = '复制失败';
} finally {
window.setTimeout(() => {
if (label) label.textContent = originalText;
}, 1800);
}
});
});
})();
</script> <section id="post-comment" class="twikoo-comments" aria-label="Comments" data-env-id="https://comment.biss.click" data-region data-path="/posts/bb18d851/" data-script="https://cdn.jsdelivr.net/npm/twikoo@1.7.7/dist/twikoo.min.js"> <div class="twikoo-comments-head"> <span class="twikoo-comments-icon" aria-hidden="true"> <svg viewBox="0 0 24 24"> <path d="M21 12a8 8 0 0 1-8 8H7l-4 3v-5a8 8 0 1 1 18-6Z"></path> </svg> </span> <div> <h2>Comments</h2> <p>为1Panel添加自己想要的应用</p> </div> </div> <div id="twikoo-wrap" class="twikoo-wrap"></div> </section> <script>
(() => {
const root = document.getElementById('post-comment');
const wrap = document.getElementById('twikoo-wrap');
if (!root || !wrap || root.dataset.twikooLoaded === 'true') return;
const envId = root.dataset.envId;
const path = root.dataset.path || window.location.pathname;
const region = root.dataset.region || undefined;
if (!envId) return;
root.dataset.twikooLoaded = 'true';
const initTwikoo = () => {
if (!window.twikoo || typeof window.twikoo.init !== 'function') return;
window.twikoo.init({
el: wrap,
envId,
region,
path,
});
};
if (window.twikoo) {
initTwikoo();
return;
}
const script = document.createElement('script');
script.src = root.dataset.script;
script.defer = true;
script.onload = initTwikoo;
script.onerror = () => {
root.dataset.twikooLoaded = 'false';
};
document.head.appendChild(script);
})();
</script> </article> <aside class="article-sidebar" aria-label="文章侧边栏"> <section class="sidebar-card article-author-card"> <img class="profile-avatar" src="https://free.picui.cn/free/2025/08/10/689845496a283.png" alt="biss" loading="lazy"> <div class="profile-name">biss</div> <div class="article-author-meta"> <span>2025/08/19</span> <a href="/categories/tech/">技术</a> </div> </section> <section class="sidebar-card article-tags-card"> <h2> <span aria-hidden="true">#</span>
文章标签
<em>1</em> </h2> <div class="article-tag-list" aria-label="文章标签"> <a href="/tags/1panel/">#1panel</a> </div> </section> <div class="article-sticky-sidebar"> <section class="sidebar-card toc-card"> <h2> <span aria-hidden="true">☰</span>
文章目录
<em>13</em> </h2> <nav class="toc-list toc-tree" aria-label="文章目录" data-toc-tree> <div class="toc-group is-open" data-toc-group data-heading-id="预准备"> <a class="toc-link toc-link-main" href="#预准备" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>预准备</span> </a> </div><div class="toc-group" data-toc-group data-heading-id="创建文件"> <a class="toc-link toc-link-main" href="#创建文件" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>创建文件</span> </a> <div class="toc-children" data-toc-children> <a class="toc-link toc-link-child toc-depth-2" href="#文件目录" data-toc-link> <span>文件目录</span> </a><a class="toc-link toc-link-child toc-depth-2" href="#应用声明文件datayml" data-toc-link> <span>应用声明文件`data.yml`</span> </a><a class="toc-link toc-link-child toc-depth-2" href="#应用标签-tags-字段" data-toc-link> <span>应用标签 - tags 字段</span> </a> </div> </div><div class="toc-group" data-toc-group data-heading-id="应用类型-type-字段"> <a class="toc-link toc-link-main" href="#应用类型-type-字段" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>应用类型 - type 字段</span> </a> </div><div class="toc-group" data-toc-group data-heading-id="应用参数配置文件-datayml"> <a class="toc-link toc-link-main" href="#应用参数配置文件-datayml" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>应用参数配置文件 data.yml</span> </a> <div class="toc-children" data-toc-children> <a class="toc-link toc-link-child toc-depth-2" href="#关于端口字段" data-toc-link> <span>关于端口字段：</span> </a><a class="toc-link toc-link-child toc-depth-2" href="#关于-type-字段" data-toc-link> <span>关于 type 字段：</span> </a><a class="toc-link toc-link-child toc-depth-2" href="#脚本" data-toc-link> <span>脚本</span> </a> </div> </div><div class="toc-group" data-toc-group data-heading-id="本地测试"> <a class="toc-link toc-link-main" href="#本地测试" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>本地测试</span> </a> </div><div class="toc-group" data-toc-group data-heading-id="提交文件"> <a class="toc-link toc-link-main" href="#提交文件" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>提交文件</span> </a> </div><div class="toc-group" data-toc-group data-heading-id="提交-pull-request"> <a class="toc-link toc-link-main" href="#提交-pull-request" data-toc-link data-toc-top> <span class="toc-marker" aria-hidden="true"></span> <span>提交 Pull Request</span> </a> </div> </nav> </section> <section class="sidebar-card same-category-card"> <h2> <span aria-hidden="true">▣</span>
同类文章
<em>8</em> </h2> <div class="same-category-list"> <a href="/posts/3f8de22/"> <strong>GPT Image2 初试</strong> <time datetime="2026-04-25T15:00:00.000Z">2026/04/25</time> </a><a href="/posts/8712baaa/"> <strong>电子价签玩法</strong> <time datetime="2026-04-19T13:46:25.000Z">2026/04/19</time> </a><a href="/posts/9b2ef00a/"> <strong>OpenGL- Cohen-Sutherland 编码裁剪算法</strong> <time datetime="2026-04-15T19:34:23.000Z">2026/04/16</time> </a><a href="/posts/7207243b/"> <strong>OpenGL-直线的扫描转换</strong> <time datetime="2026-04-11T19:01:02.000Z">2026/04/12</time> </a><a href="/posts/437a5198/"> <strong>OpenGL-基础程序</strong> <time datetime="2026-04-11T18:20:34.000Z">2026/04/12</time> </a><a href="/posts/c4477b0c/"> <strong>配置OpenGL环境</strong> <time datetime="2026-04-02T04:52:16.000Z">2026/04/02</time> </a><a href="/posts/b559997d/"> <strong>opencv应用-算术运算</strong> <time datetime="2026-03-17T13:13:08.000Z">2026/03/17</time> </a><a href="/posts/e8f95ead/"> <strong>opencv应用-基础操作</strong> <time datetime="2026-03-15T09:56:51.000Z">2026/03/15</time> </a> </div> </section> <section class="sidebar-card site-info-card" data-site-info-card data-stats-endpoint="https://blogumami.biss.click"> <h2><i class="fa-solid fa-chart-line" aria-hidden="true"></i> 网站信息</h2> <dl class="site-info-list"> <div> <dt>文章数目</dt> <dd>43</dd> </div><div> <dt>本站总字数</dt> <dd>32,569</dd> </div><div> <dt>本站访客数</dt> <dd data-stat-key="visitors">--</dd> </div><div> <dt>本站访问量</dt> <dd data-stat-key="pageviews">--</dd> </div><div> <dt>最后更新时间</dt> <dd>2026/06/19</dd> </div> </dl> </section> <script>
(() => {
const cacheDuration = 10 * 60 * 1000;
const formatter = new Intl.NumberFormat('en-US');
const cards = [...document.querySelectorAll('[data-site-info-card]')];
const endpoint = cards.find((card) => card.dataset.statsEndpoint)?.dataset.statsEndpoint;
if (!endpoint) return;
const cacheKey = `site-info-stats:${endpoint}`;
const updateCards = (stats) => {
const visitors = Number(stats?.visitors);
const pageviews = Number(stats?.pageviews);
cards.forEach((card) => {
const visitorsEl = card.querySelector('[data-stat-key="visitors"]');
const pageviewsEl = card.querySelector('[data-stat-key="pageviews"]');
if (visitorsEl && Number.isFinite(visitors)) visitorsEl.textContent = formatter.format(visitors);
if (pageviewsEl && Number.isFinite(pageviews)) pageviewsEl.textContent = formatter.format(pageviews);
});
};
try {
const cached = JSON.parse(localStorage.getItem(cacheKey) || 'null');
if (cached?.time && Date.now() - cached.time < cacheDuration) {
updateCards(cached.data);
return;
}
} catch {
localStorage.removeItem(cacheKey);
}
fetch(endpoint, { headers: { Accept: 'application/json' } })
.then((response) => {
if (!response.ok) throw new Error(`Stats request failed: ${response.status}`);
return response.json();
})
.then((data) => {
localStorage.setItem(cacheKey, JSON.stringify({ time: Date.now(), data }));
updateCards(data);
})
.catch(() => {
});
})();
</script> </div> </aside> </section> </main> <footer class="site-footer" aria-label="站点页脚"> <div class="footer-inner"> <section class="footer-top" aria-label="站点信息"> <a class="footer-brand" href="/" aria-label="Bi's Blog 首页"> <img src="/images/Bi.ico" alt="" loading="lazy"> <span>Bi&#39;s Blog</span> </a> <p class="footer-slogan">好奇心转化为代码的空间。</p> </section> <section class="footer-contact" aria-label="联系方式"> <p>联系方式</p> <div class="footer-socials"> <a href="mailto:bishsh2006@gmail.com" aria-label="发送邮件" title="发送邮件"> <i class="fa-solid fa-envelope" aria-hidden="true"></i> </a><a href="/rss.xml" aria-label="订阅 RSS" title="订阅 RSS"> <i class="fa-solid fa-rss" aria-hidden="true"></i> </a><a href="https://github.com/bishshi" target="_blank" rel="noreferrer" aria-label="GitHub" title="GitHub"> <i class="fa-brands fa-github" aria-hidden="true"></i> </a> </div> <nav class="footer-contact-links" aria-label="页脚链接"> <a href="/archives/">发展历程</a> <span aria-hidden="true">|</span><a href="/privacy/">隐私政策</a> </nav> </section> <section class="footer-bottom" aria-label="版权信息"> <div> <p>© 2025 - 2026 Bi&#39;s Blog</p> <p>blog.biss.click | 内容采用 CC BY-NC-SA 4.0 协议</p> </div> <div class="footer-meta"> <p>本站已运行：<span id="site-runtime">计算中...</span></p> <p> <a href="https://fastly.com/" target="_blank" rel="noreferrer">Fastly</a> <span aria-hidden="true">|</span><a href="https://astro.build/" target="_blank" rel="noreferrer">ASTRO</a> </p> </div> </section> </div> </footer> <aside class="hitokoto-card" aria-label="一言" data-hitokoto-card data-astro-cid-4cgfuthx> <div class="hitokoto-card__head" data-astro-cid-4cgfuthx> <button class="hitokoto-card__toggle" type="button" aria-label="展开一言" aria-expanded="true" title="一言" data-hitokoto-toggle data-astro-cid-4cgfuthx> <i class="fa-solid fa-quote-left" aria-hidden="true" data-astro-cid-4cgfuthx></i> <span data-astro-cid-4cgfuthx>一言</span> </button> <div class="hitokoto-card__actions" data-astro-cid-4cgfuthx> <button class="hitokoto-card__refresh" type="button" aria-label="换一句" title="换一句" data-hitokoto-refresh data-astro-cid-4cgfuthx> <i class="fa-solid fa-rotate" aria-hidden="true" data-astro-cid-4cgfuthx></i> </button> <button class="hitokoto-card__collapse" type="button" aria-label="收起一言" title="收起" data-hitokoto-collapse data-astro-cid-4cgfuthx> <i class="fa-solid fa-chevron-down" aria-hidden="true" data-astro-cid-4cgfuthx></i> </button> </div> </div> <a class="hitokoto-card__text" href="https://hitokoto.cn/" target="_blank" rel="noreferrer" data-hitokoto-text data-astro-cid-4cgfuthx>
获取中...
</a> <p class="hitokoto-card__from" data-hitokoto-from data-astro-cid-4cgfuthx>来自 Hitokoto</p> </aside> <script type="module">(()=>{const o=document.querySelector("[data-hitokoto-card]"),s=o?.querySelector("[data-hitokoto-toggle]"),r=o?.querySelector("[data-hitokoto-text]"),l=o?.querySelector("[data-hitokoto-from]"),k=o?.querySelector("[data-hitokoto-refresh]"),m=o?.querySelector("[data-hitokoto-collapse]");if(!(o instanceof HTMLElement)||!(s instanceof HTMLButtonElement)||!(r instanceof HTMLAnchorElement)||!(l instanceof HTMLElement))return;const g="https://yiyan.biss.click/api?encode=json",u="hitokoto-card-cache",y=360*60*1e3,d={sentence:"生活明朗，万物可爱。",source:"本地缓存",url:"https://hitokoto.cn/"},L=["/","/index.html"].includes(window.location.pathname);function c(t){o.classList.toggle("is-collapsed",!t),s.setAttribute("aria-expanded",String(t)),s.setAttribute("aria-label",t?"收起一言":"展开一言")}function f(){try{const t=localStorage.getItem(u);if(!t)return null;const e=JSON.parse(t);return!e||typeof e.expiresAt!="number"||e.expiresAt<=Date.now()?null:e.data}catch{return null}}function x(t){try{localStorage.setItem(u,JSON.stringify({data:t,expiresAt:Date.now()+y}))}catch{}}function i(t){r.textContent=t.sentence,r.href=t.url||"https://hitokoto.cn/",l.textContent=t.source?`出自 ${t.source}`:"来自 Hitokoto"}async function h({force:t=!1}={}){if(!t){const e=f();if(e){i(e);return}}o.classList.add("is-loading"),r.textContent="获取中...";try{const e=await fetch(g);if(!e.ok)throw new Error(`Hitokoto request failed: ${e.status}`);const n=await e.json(),a=n.hitokoto||n.content||n.sentence||n.text,S=typeof a=="string"&&a.trim()?a.trim():d.sentence,E=typeof n.from=="string"&&n.from.trim()?n.from.trim():"Hitokoto",w=n.uuid?`https://hitokoto.cn/?uuid=${encodeURIComponent(n.uuid)}`:"https://hitokoto.cn/",p={sentence:S,source:E,url:w};x(p),i(p)}catch(e){console.error(e),i(f()||d)}finally{o.classList.remove("is-loading")}}c(L),s.addEventListener("click",()=>{c(o.classList.contains("is-collapsed"))}),k?.addEventListener("click",t=>{t.stopPropagation(),c(!0),h({force:!0})}),m?.addEventListener("click",t=>{t.stopPropagation(),c(!1)}),o.addEventListener("click",t=>{o.classList.contains("is-collapsed")&&(t.target instanceof Element&&t.target.closest("a, button")||c(!0))}),h()})();</script> <div class="custom-context-menu" data-context-menu role="menu" aria-hidden="true"> <div class="context-menu-nav" aria-label="页面导航"> <button type="button" data-context-action="back" aria-label="后退上一页" title="后退上一页"> <i class="fa-solid fa-arrow-left" aria-hidden="true"></i> </button> <button type="button" data-context-action="forward" aria-label="前进下一页" title="前进下一页"> <i class="fa-solid fa-arrow-right" aria-hidden="true"></i> </button> <button type="button" data-context-action="reload" aria-label="刷新页面" title="刷新页面"> <i class="fa-solid fa-rotate-right" aria-hidden="true"></i> </button> <a href="/" aria-label="返回首页" title="返回首页"> <i class="fa-solid fa-house" aria-hidden="true"></i> </a> </div> <div class="context-menu-group" data-selection-group hidden> <button type="button" data-context-action="copy-selection" data-selection-item> <i class="fa-regular fa-copy" aria-hidden="true"></i> <span>复制选中文字</span> </button> <button type="button" data-context-action="search-selection" data-selection-item> <i class="fa-brands fa-microsoft" aria-hidden="true"></i> <span>用 Bing 搜索</span> </button> <button type="button" data-context-action="quote-selection" data-selection-item data-comments-item> <i class="fa-regular fa-comment-dots" aria-hidden="true"></i> <span>引用到评论区</span> </button> </div> <div class="context-menu-group" data-image-group hidden> <button type="button" data-context-action="copy-image"> <i class="fa-regular fa-image" aria-hidden="true"></i> <span>复制图片</span> </button> <button type="button" data-context-action="open-image"> <i class="fa-solid fa-up-right-from-square" aria-hidden="true"></i> <span>新页面打开图片</span> </button> <button type="button" data-context-action="copy-image-url"> <i class="fa-solid fa-link" aria-hidden="true"></i> <span>复制图片地址</span> </button> </div> <div class="context-menu-group"> <a href="/archives/"> <i class="fa-solid fa-box-archive" aria-hidden="true"></i> <span>时间线</span> </a> <a href="/categories/"> <i class="fa-solid fa-folder" aria-hidden="true"></i> <span>分类</span> </a> <a href="/tags/"> <i class="fa-solid fa-hashtag" aria-hidden="true"></i> <span>标签</span> </a> <button type="button" data-context-action="comments" data-comments-item> <i class="fa-regular fa-comment-dots" aria-hidden="true"></i> <span>跳转评论区</span> </button> <button type="button" data-context-action="print"> <i class="fa-solid fa-print" aria-hidden="true"></i> <span>打印页面</span> </button> <a href="/cc/"> <i class="fa-solid fa-circle-info" aria-hidden="true"></i> <span>网站版权</span> </a> </div> </div> <script>
(() => {
const menu = document.querySelector('[data-context-menu]');
if (!menu) return;
const selectionItems = [...menu.querySelectorAll('[data-selection-item]')];
const selectionGroup = menu.querySelector('[data-selection-group]');
const commentsItems = [...menu.querySelectorAll('[data-comments-item]')];
const imageGroup = menu.querySelector('[data-image-group]');
const focusableSelector = 'a[href], button:not([disabled])';
let lastSelectionText = '';
let lastImage = null;
const isNativeContextTarget = (target) =>
target instanceof Element &&
Boolean(target.closest('input, textarea, select, [contenteditable="true"], [contenteditable=""]'));
const getCommentsTarget = () =>
document.querySelector('.twikoo-comments, #twikoo-wrap, #twikoo, .tk-comments-container');
const getSelectionText = () => String(window.getSelection?.() || '').trim();
const getImageTarget = (target) => {
if (!(target instanceof Element)) return null;
const image = target.closest('img');
return image instanceof HTMLImageElement ? image : null;
};
const getImageUrl = () => {
if (!lastImage) return '';
return lastImage.currentSrc || lastImage.src || lastImage.getAttribute('src') || '';
};
const copyText = async (text) => {
if (navigator.clipboard?.writeText) {
await navigator.clipboard.writeText(text);
return;
}
const textarea = document.createElement('textarea');
textarea.value = text;
textarea.setAttribute('readonly', '');
textarea.style.position = 'fixed';
textarea.style.inset = '0 auto auto -9999px';
document.body.appendChild(textarea);
textarea.select();
document.execCommand('copy');
textarea.remove();
};
const setMenuState = () => {
const hasSelection = lastSelectionText.length > 0;
const hasComments = Boolean(getCommentsTarget());
const hasImage = Boolean(getImageUrl());
selectionItems.forEach((item) => {
item.hidden = !hasSelection;
});
if (selectionGroup) selectionGroup.hidden = !hasSelection;
commentsItems.forEach((item) => {
item.hidden = !hasComments || (item.hasAttribute('data-selection-item') && !hasSelection);
});
if (imageGroup) imageGroup.hidden = !hasImage;
};
const closeMenu = () => {
menu.classList.remove('is-open');
menu.setAttribute('aria-hidden', 'true');
};
const openMenu = (x, y) => {
setMenuState();
menu.classList.add('is-open');
menu.setAttribute('aria-hidden', 'false');
const rect = menu.getBoundingClientRect();
const gap = 10;
const left = Math.min(Math.max(gap, x), window.innerWidth - rect.width - gap);
const top = Math.min(Math.max(gap, y), window.innerHeight - rect.height - gap);
menu.style.left = `${left}px`;
menu.style.top = `${top}px`;
};
const jumpToComments = () => {
const target = getCommentsTarget();
target?.scrollIntoView({ behavior: 'smooth', block: 'start' });
};
const quoteToComments = () => {
jumpToComments();
window.setTimeout(() => {
const textarea = document.querySelector('#twikoo textarea, .twikoo-comments textarea, .tk-input textarea');
if (!(textarea instanceof HTMLTextAreaElement) || !lastSelectionText) return;
const quote = lastSelectionText
.split(/\r?\n/)
.map((line) => `> ${line}`)
.join('\n');
const current = textarea.value.trim();
textarea.value = current ? `${current}\n\n${quote}\n` : `${quote}\n`;
textarea.dispatchEvent(new Event('input', { bubbles: true }));
textarea.focus();
}, 500);
};
const searchSelection = () => {
if (!lastSelectionText) return;
const url = `https://www.bing.com/search?q=${encodeURIComponent(lastSelectionText)}`;
window.open(url, '_blank', 'noopener,noreferrer');
};
const copyImage = async () => {
const imageUrl = getImageUrl();
if (!imageUrl) return;
try {
if (!navigator.clipboard?.write || typeof ClipboardItem === 'undefined') {
throw new Error('Image clipboard is not available.');
}
const response = await fetch(imageUrl, { mode: 'cors' });
const blob = await response.blob();
await navigator.clipboard.write([
new ClipboardItem({ [blob.type || 'image/png']: blob }),
]);
} catch {
await copyText(new URL(imageUrl, window.location.href).toString());
}
};
const openImage = () => {
const imageUrl = getImageUrl();
if (!imageUrl) return;
window.open(new URL(imageUrl, window.location.href).toString(), '_blank', 'noopener,noreferrer');
};
document.addEventListener('contextmenu', (event) => {
if (isNativeContextTarget(event.target)) return;
lastSelectionText = getSelectionText();
lastImage = getImageTarget(event.target);
event.preventDefault();
openMenu(event.clientX, event.clientY);
});
document.addEventListener('click', (event) => {
const actionTarget = event.target instanceof Element ? event.target.closest('[data-context-action]') : null;
if (!actionTarget || !menu.contains(actionTarget)) {
closeMenu();
return;
}
const action = actionTarget.dataset.contextAction;
closeMenu();
if (action === 'back') history.back();
if (action === 'forward') history.forward();
if (action === 'reload') location.reload();
if (action === 'copy-selection' && lastSelectionText) copyText(lastSelectionText);
if (action === 'search-selection') searchSelection();
if (action === 'quote-selection') quoteToComments();
if (action === 'copy-image') copyImage();
if (action === 'open-image') openImage();
if (action === 'copy-image-url') copyText(new URL(getImageUrl(), window.location.href).toString());
if (action === 'comments') jumpToComments();
if (action === 'print') window.print();
});
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') closeMenu();
if (event.key === 'Tab' && menu.classList.contains('is-open')) {
const items = [...menu.querySelectorAll(focusableSelector)].filter((item) => !item.closest('[hidden]'));
if (items.length === 0) return;
const first = items[0];
const last = items[items.length - 1];
if (event.shiftKey && document.activeElement === first) {
event.preventDefault();
last.focus();
} else if (!event.shiftKey && document.activeElement === last) {
event.preventDefault();
first.focus();
}
}
});
window.addEventListener('scroll', closeMenu, { passive: true });
window.addEventListener('resize', closeMenu);
})();
</script> <script src="https://cdn.jsdmirror.com/npm/instantsearch.js@4.56.0"></script> <script src="https://cdn.jsdmirror.com/npm/typesense-instantsearch-adapter@2.7.0/dist/typesense-instantsearch-adapter.min.js"></script> <script src="https://cdn.jsdmirror.com/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.umd.js"></script> <script src="/js/random.js"></script> <script src="/js/search/typesense-search.js"></script> <script src="/js/external-links.js"></script> <script>
(() => {
const nav = document.querySelector('.nav');
const toggle = document.querySelector('[data-nav-toggle]');
const menu = document.querySelector('[data-nav-menu]');
if (!nav || !toggle || !menu) return;
function setMenu(open) {
nav.classList.toggle('is-open', open);
toggle.setAttribute('aria-expanded', String(open));
toggle.setAttribute('aria-label', open ? '关闭菜单' : '打开菜单');
}
toggle.addEventListener('click', () => {
setMenu(!nav.classList.contains('is-open'));
});
menu.addEventListener('click', (event) => {
if (event.target instanceof Element && event.target.closest('a')) setMenu(false);
});
window.addEventListener('resize', () => {
if (window.innerWidth > 720) setMenu(false);
});
})();
(() => {
const storageKey = 'site-theme';
const root = document.documentElement;
const button = document.querySelector('[data-theme-toggle]');
const media = window.matchMedia('(prefers-color-scheme: dark)');
const getSystemTheme = () => (media.matches ? 'dark' : 'light');
const getTheme = () => localStorage.getItem(storageKey) || getSystemTheme();
function applyTheme(theme) {
root.dataset.theme = theme;
button?.setAttribute('aria-label', theme === 'dark' ? '切换到日间模式' : '切换到夜间模式');
button?.setAttribute('title', theme === 'dark' ? '切换到日间模式' : '切换到夜间模式');
}
applyTheme(getTheme());
button?.addEventListener('click', () => {
const nextTheme = root.dataset.theme === 'dark' ? 'light' : 'dark';
localStorage.setItem(storageKey, nextTheme);
applyTheme(nextTheme);
});
media.addEventListener('change', () => {
if (!localStorage.getItem(storageKey)) applyTheme(getSystemTheme());
});
})();
(() => {
const runtime = document.getElementById('site-runtime');
if (!runtime) return;
const start = new Date(window.SITE_CONFIG.site.startTime).getTime();
const pad = (value) => String(value).padStart(2, '0');
function updateRuntime() {
const diff = Math.max(0, Date.now() - start);
const days = Math.floor(diff / 86400000);
const hours = Math.floor((diff / 3600000) % 24);
const minutes = Math.floor((diff / 60000) % 60);
const seconds = Math.floor((diff / 1000) % 60);
runtime.textContent = `${days} 天 ${pad(hours)} 时 ${pad(minutes)} 分 ${pad(seconds)} 秒`;
}
updateRuntime();
window.setInterval(updateRuntime, 1000);
})();
</script> </body> </html> <script>
(() => {
const prose = document.querySelector('.prose[data-toc]');
if (!prose) return;
let toc = [];
try {
toc = JSON.parse(prose.dataset.toc || '[]');
} catch {
toc = [];
}
prose.querySelectorAll('h1, h2, h3').forEach((heading, index) => {
const item = toc[index];
if (item?.id && !heading.id) heading.id = item.id;
});
const tocTree = document.querySelector('[data-toc-tree]');
if (tocTree && toc.length > 0) {
const links = [...tocTree.querySelectorAll('[data-toc-link]')];
const groups = [...tocTree.querySelectorAll('[data-toc-group]')];
const headings = toc
.map((item) => document.getElementById(item.id))
.filter(Boolean);
const setActiveToc = (id) => {
links.forEach((link) => {
const isActive = link.getAttribute('href') === `#${id}`;
link.classList.toggle('is-active', isActive);
if (isActive) link.setAttribute('aria-current', 'location');
else link.removeAttribute('aria-current');
});
const activeLink = tocTree.querySelector(`[data-toc-link][href="#${CSS.escape(id)}"]`);
const activeGroup = activeLink?.closest('[data-toc-group]');
groups.forEach((group) => group.classList.toggle('is-open', group === activeGroup));
};
const updateToc = () => {
const anchorOffset = 132;
let activeId = headings[0]?.id;
headings.forEach((heading) => {
if (heading.getBoundingClientRect().top <= anchorOffset) activeId = heading.id;
});
if (activeId) setActiveToc(activeId);
};
tocTree.addEventListener('click', (event) => {
const link = event.target.closest?.('[data-toc-link]');
if (!link) return;
const group = link.closest('[data-toc-group]');
groups.forEach((item) => item.classList.toggle('is-open', item === group));
});
updateToc();
window.addEventListener('scroll', updateToc, { passive: true });
window.addEventListener('resize', updateToc);
}
const summaryText = document.querySelector('.article-summary-text');
if (!summaryText) return;
const fullText = summaryText.dataset.summaryText || summaryText.textContent || '';
const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (reduceMotion) {
summaryText.textContent = fullText;
return;
}
summaryText.textContent = '';
let index = 0;
function typeSummary() {
index += 1;
summaryText.textContent = fullText.slice(0, index);
if (index < fullText.length) {
window.setTimeout(typeSummary, 34);
}
}
window.setTimeout(typeSummary, 280);
})();
</script> <script>
(() => {
const prose = document.querySelector('.post-article .prose');
if (!prose) return;
const collapsedLineCount = 8;
const copyLabels = {
idle: '复制',
done: '已复制',
error: '复制失败',
};
const languageNames = {
bash: 'Bash',
c: 'C',
cpp: 'C++',
cs: 'C#',
css: 'CSS',
html: 'HTML',
js: 'JavaScript',
json: 'JSON',
jsx: 'JSX',
md: 'Markdown',
powershell: 'PowerShell',
py: 'Python',
shell: 'Shell',
sh: 'Shell',
ts: 'TypeScript',
tsx: 'TSX',
txt: 'Text',
yaml: 'YAML',
yml: 'YAML',
};
function getCodeLanguage(pre, code) {
const rawLanguage =
pre.dataset.language ||
code.dataset.language ||
[...pre.classList, ...code.classList]
.find((className) => className.startsWith('language-'))
?.replace(/^language-/, '') ||
'';
const normalized = rawLanguage.trim().toLowerCase();
return languageNames[normalized] || normalized.toUpperCase() || 'Code';
}
function getCodeText(code, lines) {
if (lines.length > 0) return lines.map((line) => line.textContent || '').join('\n');
return code.textContent || '';
}
prose.querySelectorAll('img').forEach((image) => {
if (image.closest('a, .article-header-cover')) return;
const src = image.currentSrc || image.getAttribute('src');
if (!src) return;
const link = document.createElement('a');
link.className = 'fancybox';
link.href = src;
link.dataset.fancybox = 'article-gallery';
link.dataset.caption = image.getAttribute('alt') || '';
image.parentNode?.insertBefore(link, image);
link.appendChild(image);
});
prose.querySelectorAll('table').forEach((table) => {
if (table.closest('.table-scroll')) return;
const wrapper = document.createElement('div');
wrapper.className = 'table-scroll';
table.parentNode?.insertBefore(wrapper, table);
wrapper.appendChild(table);
});
prose.querySelectorAll('.butterfly-hide-inline').forEach((item) => {
const button = item.querySelector('.butterfly-hide-toggle');
if (!button) return;
button.addEventListener('click', () => {
item.classList.toggle('is-open');
});
});
if (window.Fancybox) {
window.Fancybox.bind('[data-fancybox="article-gallery"]', {
compact: false,
dragToClose: true,
Images: {
zoom: true,
},
});
}
async function copyText(text) {
if (navigator.clipboard?.writeText) {
await navigator.clipboard.writeText(text);
return;
}
const textarea = document.createElement('textarea');
textarea.value = text;
textarea.setAttribute('readonly', '');
textarea.style.position = 'fixed';
textarea.style.top = '-9999px';
textarea.style.opacity = '0';
document.body.appendChild(textarea);
textarea.select();
document.execCommand('copy');
textarea.remove();
}
prose.querySelectorAll('pre').forEach((pre) => {
if (pre.closest('.code-block')) return;
const code = pre.querySelector('code');
if (!code) return;
const wrapper = document.createElement('div');
wrapper.className = 'code-block';
pre.parentNode?.insertBefore(wrapper, pre);
wrapper.appendChild(pre);
const header = document.createElement('div');
header.className = 'code-block-header';
const language = document.createElement('span');
language.className = 'code-block-language';
language.textContent = getCodeLanguage(pre, code);
const toolbar = document.createElement('div');
toolbar.className = 'code-block-toolbar';
const copyButton = document.createElement('button');
copyButton.className = 'code-block-copy';
copyButton.type = 'button';
copyButton.textContent = copyLabels.idle;
copyButton.setAttribute('aria-label', '复制代码');
const toggleButton = document.createElement('button');
toggleButton.className = 'code-block-toggle';
toggleButton.type = 'button';
toggleButton.textContent = '展开';
toggleButton.setAttribute('aria-expanded', 'false');
toolbar.append(copyButton, toggleButton);
header.append(language, toolbar);
wrapper.appendChild(header);
const codeLines = [...code.querySelectorAll(':scope > .line')];
if (codeLines.length > 0) {
wrapper.classList.add('has-line-numbers');
wrapper.style.setProperty('--line-number-width', `${String(codeLines.length).length + 1}ch`);
codeLines.forEach((line, index) => {
line.dataset.line = String(index + 1);
});
}
const lineCount = codeLines.length || (code.textContent || '').split(/\r?\n/).length;
if (lineCount > collapsedLineCount) wrapper.classList.add('is-collapsible');
copyButton.addEventListener('click', async () => {
try {
await copyText(getCodeText(code, codeLines));
copyButton.textContent = copyLabels.done;
window.setTimeout(() => {
copyButton.textContent = copyLabels.idle;
}, 1400);
} catch {
copyButton.textContent = copyLabels.error;
window.setTimeout(() => {
copyButton.textContent = copyLabels.idle;
}, 1600);
}
});
toggleButton.addEventListener('click', () => {
const isExpanded = wrapper.classList.toggle('is-expanded');
toggleButton.textContent = isExpanded ? '收起' : '展开';
toggleButton.setAttribute('aria-expanded', String(isExpanded));
});
});
})();
</script>
Reference in New Issue View Git Blame Copy Permalink