tcjlj/flvx
1
0
Fork 0
mirror of https://github.com/Sagit-chu/flvx.git synced 2026-09-29 07:56:37 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
b1ee8f1d2062fbb20c4657cd818d16dece46043a
flvx/faq/index.html
T
github-actions[bot] b1ee8f1d20 Deployed a820c49 with MkDocs version: 1.6.1
2026-08-08 03:46:03 +00:00

877 lines
21 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
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" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="FLVX官方文档">
<meta name="author" content="Sagit-chu">
<link rel="canonical" href="https://sagit-chu.github.io/flux-panel/faq/">
<link rel="prev" href="../postgresql/">
<link rel="icon" href="../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
<title>常见问题 - FLVX 文档</title>
<link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
<link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#faq" class="md-skip">
跳转至
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="页眉">
<a href=".." title="FLVX 文档" class="md-header__button md-logo" aria-label="FLVX 文档" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
FLVX 文档
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
常见问题
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-hidden="true" type="radio" name="__palette" id="__palette_0">
<input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="搜索" placeholder="搜索" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</label>
<nav class="md-search__options" aria-label="查找">
<button type="reset" class="md-search__icon md-icon" title="清空当前内容" aria-label="清空当前内容" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
正在初始化搜索引擎
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<nav class="md-tabs" aria-label="标签" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href=".." class="md-tabs__link">
首页
</a>
</li>
<li class="md-tabs__item">
<a href="../install/" class="md-tabs__link">
安装部署
</a>
</li>
<li class="md-tabs__item">
<a href="../usage/" class="md-tabs__link">
使用指南
</a>
</li>
<li class="md-tabs__item">
<a href="../ai-skill/" class="md-tabs__link">
AI Skill 接入
</a>
</li>
<li class="md-tabs__item">
<a href="../postgresql/" class="md-tabs__link">
PostgreSQL
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="./" class="md-tabs__link">
常见问题
</a>
</li>
</ul>
</div>
</nav>
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="导航栏" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href=".." title="FLVX 文档" class="md-nav__button md-logo" aria-label="FLVX 文档" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
FLVX 文档
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href=".." class="md-nav__link">
<span class="md-ellipsis">
首页
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../install/" class="md-nav__link">
<span class="md-ellipsis">
安装部署
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../usage/" class="md-nav__link">
<span class="md-ellipsis">
使用指南
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../ai-skill/" class="md-nav__link">
<span class="md-ellipsis">
AI Skill 接入
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../postgresql/" class="md-nav__link">
<span class="md-ellipsis">
PostgreSQL
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
常见问题
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
常见问题
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="目录">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
目录
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#q1-docker-command-not-found" class="md-nav__link">
<span class="md-ellipsis">
Q1: 安装脚本提示 "Docker command not found"？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q2-connection-refused" class="md-nav__link">
<span class="md-ellipsis">
Q2: 面板无法访问 (Connection Refused)？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q3" class="md-nav__link">
<span class="md-ellipsis">
Q3: 节点显示离线？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q4-tcp-udp" class="md-nav__link">
<span class="md-ellipsis">
Q4: 只有 TCP 能通，UDP 不通？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q5-ipv6" class="md-nav__link">
<span class="md-ellipsis">
Q5: IPv6 无法使用？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q6-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q6: 如何切换到 PostgreSQL？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q7-sqlite-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q7: 从 SQLite 迁移到 PostgreSQL 后数据丢失？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q8-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q8: PostgreSQL 容器启动失败？
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="目录">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
目录
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#q1-docker-command-not-found" class="md-nav__link">
<span class="md-ellipsis">
Q1: 安装脚本提示 "Docker command not found"？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q2-connection-refused" class="md-nav__link">
<span class="md-ellipsis">
Q2: 面板无法访问 (Connection Refused)？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q3" class="md-nav__link">
<span class="md-ellipsis">
Q3: 节点显示离线？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q4-tcp-udp" class="md-nav__link">
<span class="md-ellipsis">
Q4: 只有 TCP 能通，UDP 不通？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q5-ipv6" class="md-nav__link">
<span class="md-ellipsis">
Q5: IPv6 无法使用？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q6-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q6: 如何切换到 PostgreSQL？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q7-sqlite-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q7: 从 SQLite 迁移到 PostgreSQL 后数据丢失？
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#q8-postgresql" class="md-nav__link">
<span class="md-ellipsis">
Q8: PostgreSQL 容器启动失败？
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="faq">常见问题 (FAQ)</h1>
<h3 id="q1-docker-command-not-found">Q1: 安装脚本提示 "Docker command not found"？</h3>
<p><strong>A</strong>: 请确保您的系统已安装 Docker 和 Docker Compose。
- Ubuntu/Debian 安装 Docker: <code>curl -fsSL https://get.docker.com | bash</code></p>
<h3 id="q2-connection-refused">Q2: 面板无法访问 (Connection Refused)？</h3>
<p><strong>A</strong>:
1. 检查防火墙是否放行了前端端口（默认 <code>6366</code>）。
2. 检查容器是否正常运行: <code>docker ps</code>。
3. 查看容器日志: <code>docker logs flux-panel-backend</code> 或 <code>docker logs vite-frontend</code>。</p>
<h3 id="q3">Q3: 节点显示离线？</h3>
<p><strong>A</strong>:
1. 检查节点服务器与面板服务器之间的网络连通性。
2. 确认在节点端安装时输入的 <strong>面板地址</strong> 和 <strong>密钥</strong> 是否正确。
3. 检查节点端服务状态: <code>systemctl status flux_agent</code>。
4. 查看节点端日志: <code>journalctl -u flux_agent -f</code>。</p>
<h3 id="q4-tcp-udp">Q4: 只有 TCP 能通，UDP 不通？</h3>
<p><strong>A</strong>: 请检查服务器防火墙和安全组（AWS/阿里云/腾讯云等）是否同时放行了对应端口的 <strong>TCP 和 UDP</strong> 协议。</p>
<h3 id="q5-ipv6">Q5: IPv6 无法使用？</h3>
<p><strong>A</strong>: 面板安装脚本会自动尝试配置 Docker 的 IPv6。如果失败，请手动检查 <code>/etc/docker/daemon.json</code> 配置，确保 <code>ipv6: true</code> 且分配了正确的 <code>fixed-cidr-v6</code> 子网。</p>
<h3 id="q6-postgresql">Q6: 如何切换到 PostgreSQL？</h3>
<p><strong>A</strong>: 在 <code>.env</code> 文件中设置 <code>DB_TYPE=postgres</code>，并让 <code>DATABASE_URL</code> 与 <code>POSTGRES_*</code> 保持一致，然后执行 <code>docker compose up -d</code> 重启服务即可。使用安装脚本部署时，<code>POSTGRES_PASSWORD</code> 会自动随机生成并写入 <code>.env</code>。详见 <a href="../postgresql/">PostgreSQL 数据库指南</a>。</p>
<h3 id="q7-sqlite-postgresql">Q7: 从 SQLite 迁移到 PostgreSQL 后数据丢失？</h3>
<p><strong>A</strong>:
1. 确认迁移前已备份 SQLite 文件（<code>gost.db.bak</code>）。
2. 确认 <code>pgloader</code> 命令执行成功，检查其输出是否有报错。
3. 确认 <code>.env</code> 中 <code>DATABASE_URL</code> 的密码与 <code>POSTGRES_PASSWORD</code> 一致。
4. 详细迁移步骤参考 <a href="../postgresql/">PostgreSQL 数据库指南 - 从 SQLite 迁移</a>。</p>
<h3 id="q8-postgresql">Q8: PostgreSQL 容器启动失败？</h3>
<p><strong>A</strong>:
1. 检查 <code>POSTGRES_PASSWORD</code> 是否已设置（不能为空）。
2. 查看容器日志：<code>docker logs flux-panel-postgres</code>。
3. 如果是首次启动后修改了密码，需要删除旧的数据卷重新初始化：<code>docker volume rm postgres_data</code>。</p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
回到页面顶部
</button>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "search.suggest", "search.highlight", "content.code.copy"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "\u5df2\u590d\u5236", "clipboard.copy": "\u590d\u5236", "search.result.more.one": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.more.other": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 # \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.none": "\u6ca1\u6709\u627e\u5230\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.one": "\u627e\u5230 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.other": "# \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.placeholder": "\u952e\u5165\u4ee5\u5f00\u59cb\u641c\u7d22", "search.result.term.missing": "\u7f3a\u5c11", "select.version": "\u9009\u62e9\u5f53\u524d\u7248\u672c"}, "version": null}</script>
<script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink