{"id":2554,"date":"2025-07-25T16:17:20","date_gmt":"2025-07-25T08:17:20","guid":{"rendered":"https:\/\/sanlangcode.com\/?p=2554"},"modified":"2025-07-25T16:17:20","modified_gmt":"2025-07-25T08:17:20","slug":"%f0%9f%a7%91%f0%9f%92%bb-ragflow-%e6%b2%99%e7%ae%b1%e6%9c%ac%e5%9c%b0%e5%90%af%e5%8a%a8%e5%85%a8%e9%93%be%e8%b7%af%e7%9c%9f%e7%9b%b8%e6%ba%af%e6%ba%90","status":"publish","type":"post","link":"https:\/\/sanlangcode.com\/index.php\/2025\/07\/25\/%f0%9f%a7%91%f0%9f%92%bb-ragflow-%e6%b2%99%e7%ae%b1%e6%9c%ac%e5%9c%b0%e5%90%af%e5%8a%a8%e5%85%a8%e9%93%be%e8%b7%af%e7%9c%9f%e7%9b%b8%e6%ba%af%e6%ba%90\/","title":{"rendered":"\ud83e\uddd1\u200d\ud83d\udcbb Ragflow \u6c99\u7bb1\u672c\u5730\u542f\u52a8\u5168\u94fe\u8def\u771f\u76f8\u6eaf\u6e90"},"content":{"rendered":"\n<p><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\u201c\u672c\u5730\u80fd\u8dd1\u901a\uff0c\u624d\u662f\u771f\u7684\u901a\u3002\u2014\u2014 \u4f46\u4f60\u5f97\u77e5\u9053\uff0c<strong>\u5230\u5e95\u662f\u54ea\u91cc\u8ba9\u5b83\u901a\u4e86<\/strong>\u3002\u201d<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u76ee\u5f55<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"#\u80cc\u666f\u4e0e\u76ee\u6807\">\u80cc\u666f\u4e0e\u76ee\u6807<\/a><\/li>\n\n\n\n<li><a href=\"#\u9879\u76ee\u7ed3\u6784\u4e0e\u5173\u952e\u4f9d\u8d56\">\u9879\u76ee\u7ed3\u6784\u4e0e\u5173\u952e\u4f9d\u8d56<\/a><\/li>\n\n\n\n<li><a href=\"#\u6c99\u7bb1\u670d\u52a1\u542f\u52a8\u7684\u771f\u6b63\u5173\u952e\">\u6c99\u7bb1\u670d\u52a1\u542f\u52a8\u7684\u771f\u6b63\u5173\u952e<\/a><\/li>\n\n\n\n<li><a href=\"#\u540e\u7aef-code-\u7ec4\u4ef6\u80fd\u7528\u6c99\u7bb1\u7684\u672c\u8d28\u6761\u4ef6\">\u540e\u7aef code \u7ec4\u4ef6\u80fd\u7528\u6c99\u7bb1\u7684\u672c\u8d28\u6761\u4ef6<\/a><\/li>\n\n\n\n<li><a href=\"#\u5e38\u89c1\u62a5\u9519\u4e0e\u672c\u8d28\u539f\u56e0\">\u5e38\u89c1\u62a5\u9519\u4e0e\u672c\u8d28\u539f\u56e0<\/a><\/li>\n\n\n\n<li><a href=\"#\u6700\u7ec8\u53ef\u7528\u7684\u542f\u52a8\u987a\u5e8f\u4e0e\u914d\u7f6e\">\u6700\u7ec8\u53ef\u7528\u7684\u542f\u52a8\u987a\u5e8f\u4e0e\u914d\u7f6e<\/a><\/li>\n\n\n\n<li><a href=\"#\u7ed3\u8bed\u672c\u5730\u8dd1\u901a\u7684\u771f\u76f8\">\u7ed3\u8bed\uff1a\u672c\u5730\u8dd1\u901a\u7684\u201c\u771f\u76f8\u201d<\/a><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u80cc\u666f\u4e0e\u76ee\u6807<\/h2>\n\n\n\n<p>ragflow \u662f\u4e00\u4e2a\u591a\u7ec4\u4ef6\u3001\u5f3a\u4f9d\u8d56\u7684 AI \u5e94\u7528\u5e73\u53f0\u3002<strong>\u672c\u5730\u542f\u52a8 ragflow + \u6c99\u7bb1 + code \u7ec4\u4ef6<\/strong>\uff0c\u8ba9\u4f60\u80fd\u5728 Mac \u4e0a\u5b8c\u6574\u4f53\u9a8c\u201c\u4ee3\u7801\u5b89\u5168\u6267\u884c\u201d\u7684\u5168\u94fe\u8def\u3002<\/p>\n\n\n\n<p>\u4f46\u5f88\u591a\u4eba\uff08\u5305\u62ec\u6211\uff09\u4f1a\u9047\u5230\u201c\u6c99\u7bb1\u8d77\u4e0d\u6765\u201d\u201ccode \u7ec4\u4ef6\u62a5\u9519\u201d\u201c\u73af\u5883\u53d8\u91cf\u65e0\u6548\u201d\u7b49\u95ee\u9898\u3002<strong>\u672c\u6587\u8981\u641e\u6e05\u695a\uff1a\u5230\u5e95\u54ea\u4e9b\u914d\u7f6e\/\u64cd\u4f5c\u662f\u201c\u5fc5\u987b\u7684\u201d\uff0c\u54ea\u4e9b\u662f\u201c\u65e0\u5173\u7d27\u8981\u7684\u201d\uff1f<\/strong><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u9879\u76ee\u7ed3\u6784\u4e0e\u5173\u952e\u4f9d\u8d56<\/h2>\n\n\n\n<p>\u4f60\u7684\u9879\u76ee\u7ed3\u6784\u5927\u81f4\u5982\u4e0b\uff1a<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ragflow-main\/\n  \u251c\u2500\u2500 api\/                # \u540e\u7aef\u4e3b\u670d\u52a1\n  \u251c\u2500\u2500 sandbox\/            # \u6c99\u7bb1\u670d\u52a1\uff08\u5b89\u5168\u4ee3\u7801\u6267\u884c\uff09\n  \u251c\u2500\u2500 web\/                # \u524d\u7aef\n  \u251c\u2500\u2500 docker\/             # \u4f9d\u8d56\u670d\u52a1\u7f16\u6392\uff08ES\u3001MySQL\u7b49\uff09\n  \u251c\u2500\u2500 .venv\/              # Python \u865a\u62df\u73af\u5883\n  \u251c\u2500\u2500 .env                # \u73af\u5883\u53d8\u91cf\uff08\u53ef\u9009\uff09\n  \u2514\u2500\u2500 ...                 # \u5176\u4ed6<\/code><\/pre>\n\n\n\n<p><strong>\u5173\u952e\u4f9d\u8d56\uff1a<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Docker + docker-compose\uff08\u542f\u52a8 ES\u3001MySQL\u3001Minio\u3001Redis \u7b49\uff09<\/li>\n\n\n\n<li>Python \u865a\u62df\u73af\u5883\uff08\u540e\u7aef\u3001\u6c99\u7bb1\uff09<\/li>\n\n\n\n<li>Node.js\uff08\u524d\u7aef\uff09<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u6c99\u7bb1\u670d\u52a1\u542f\u52a8\u7684\u771f\u6b63\u5173\u952e<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u542f\u52a8\u547d\u4ee4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>cd sandbox\nexport SANDBOX_ENABLED=1\nexport SANDBOX_HOST=127.0.0.1\nbash scripts\/start.sh<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">2. <strong>\u5fc5\u987b\u4fdd\u8bc1\u7684\u70b9<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u7aef\u53e3 9385 \u6ca1\u88ab\u5360\u7528<\/strong>\uff08\u5426\u5219\u6c99\u7bb1\u8d77\u4e0d\u6765\uff0c\u6216\u8005\u8d77\u4e86\u591a\u4e2a\u51b2\u7a81\uff09<\/li>\n\n\n\n<li><strong>\u4e0d\u8981\u7528 docker-compose \u548c bash \u542f\u52a8\u6c99\u7bb1\u670d\u52a1\u201c\u540c\u65f6\u8fdb\u884c\u201d<\/strong>\uff0c\u5426\u5219\u7aef\u53e3\u51b2\u7a81<\/li>\n\n\n\n<li><strong>\u73af\u5883\u53d8\u91cf SANDBOX_ENABLED\/SANDBOX_HOST<\/strong> \u5bf9\u4e8e bash \u811a\u672c\u4e0d\u662f\u5fc5\u987b\uff0c\u4f46<strong>\u5bf9\u540e\u7aef\u4e3b\u670d\u52a1\u662f\u5fc5\u987b\u7684<\/strong>\uff08\u89c1\u4e0b\u6587\uff09<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">3. \u542f\u52a8\u6210\u529f\u7684\u6807\u5fd7<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>curl http:\/\/localhost:9385\/healthz<\/code> \u8fd4\u56de <code>{\"status\":\"ok\"}<\/code><\/li>\n\n\n\n<li><code>http:\/\/localhost:9385\/docs<\/code> \u80fd\u8bbf\u95ee<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u540e\u7aef code \u7ec4\u4ef6\u80fd\u7528\u6c99\u7bb1\u7684\u672c\u8d28\u6761\u4ef6<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u5173\u952e\u4ee3\u7801\u6eaf\u6e90<\/h3>\n\n\n\n<p>\u5728 <code>agent\/component\/code.py<\/code> \u91cc\uff0ccode \u7ec4\u4ef6\u6267\u884c\u4ee3\u7801\u65f6\u4f1a\u52a8\u6001\u83b7\u53d6\u6c99\u7bb1\u5730\u5740\uff1a<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if address is None:\n    from api import settings\n    if settings.SANDBOX_ENABLED and settings.SANDBOX_HOST:\n        address = f\"http:\/\/{settings.SANDBOX_HOST}:9385\/run\"\n    else:\n        return Code.be_output(\"**Error**: Sandbox is not enabled or configured\")<\/code><\/pre>\n\n\n\n<p><strong>\u4e5f\u5c31\u662f\u8bf4\uff1a<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u53ea\u6709 <code>settings.SANDBOX_ENABLED<\/code> \u4e3a\u771f\uff0c\u4e14 <code>settings.SANDBOX_HOST<\/code> \u6709\u503c\uff0ccode \u7ec4\u4ef6\u624d\u4f1a\u53bb\u8c03\u7528\u6c99\u7bb1\u670d\u52a1\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u8fd9\u4e9b\u53d8\u91cf\u7684\u6765\u6e90<\/h3>\n\n\n\n<p>\u5728 <code>api\/settings.py<\/code> \u91cc\uff1a<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>SANDBOX_ENABLED = int(os.environ.get(\"SANDBOX_ENABLED\", \"0\"))\nSANDBOX_HOST = os.environ.get(\"SANDBOX_HOST\", None) if int(os.environ.get(\"SANDBOX_ENABLED\", \"0\")) else None<\/code><\/pre>\n\n\n\n<p><strong>\u4e5f\u5c31\u662f\u8bf4\uff1a<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u4f60\u5fc5\u987b\u5728<strong>\u542f\u52a8\u540e\u7aef\u670d\u52a1\u7684 shell \u73af\u5883<\/strong>\u91cc <code>export SANDBOX_ENABLED=1<\/code> \u548c <code>export SANDBOX_HOST=127.0.0.1<\/code>\uff0c\u5426\u5219 code \u7ec4\u4ef6\u6c38\u8fdc\u4e0d\u4f1a\u7528\u6c99\u7bb1\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">3. .env \u6587\u4ef6\u7684\u4f5c\u7528<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u5982\u679c\u4f60\u7528 <code>.env<\/code> \u6587\u4ef6\uff0c\u786e\u4fdd\u540e\u7aef\u670d\u52a1\u4f1a\u81ea\u52a8\u52a0\u8f7d\uff08\u6709\u7684\u9879\u76ee\u7528 dotenv\uff0c\u6709\u7684\u6ca1\u6709\uff09\u3002<\/li>\n\n\n\n<li><strong>\u4fdd\u9669\u505a\u6cd5\uff1a\u76f4\u63a5 export \u5230 shell\u3002<\/strong><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u5e38\u89c1\u62a5\u9519\u4e0e\u672c\u8d28\u539f\u56e0<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"> <code>**Error**: Sandbox is not enabled or configured<\/code><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u672c\u8d28\u539f\u56e0<\/strong>\uff1a\u540e\u7aef\u670d\u52a1\u6ca1\u8bbe\u7f6e <code>SANDBOX_ENABLED=1<\/code> \u548c <code>SANDBOX_HOST=127.0.0.1<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"> <code>TypeError: main() got an unexpected keyword argument 'a1'<\/code><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u672c\u8d28\u539f\u56e0<\/strong>\uff1acode \u7ec4\u4ef6\u4f20\u5165\u7684\u53c2\u6570\u540d\u548c\u4f60\u4ee3\u7801\u5b9a\u4e49\u7684\u4e0d\u4e00\u81f4\u3002<strong>\u53c2\u6570\u540d\u5fc5\u987b\u5b8c\u5168\u4e00\u81f4\uff01<\/strong><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u6700\u7ec8\u53ef\u7528\u7684\u542f\u52a8\u987a\u5e8f\u4e0e\u914d\u7f6e<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u542f\u52a8\u4f9d\u8d56\u670d\u52a1<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>cd docker\ndocker compose -f docker-compose-base.yml up -d<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u542f\u52a8\u6c99\u7bb1<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>cd sandbox\nbash scripts\/start.sh<\/code><\/pre>\n\n\n\n<p>\uff08\u5982\u9700 export \u73af\u5883\u53d8\u91cf\u53ef\u52a0\u4e0a\uff0c\u4f46\u5bf9\u6c99\u7bb1\u672c\u8eab\u4e0d\u662f\u5fc5\u987b\uff09<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">3. \u542f\u52a8\u540e\u7aef\u670d\u52a1\uff08<strong>\u5173\u952e\u70b9<\/strong>\uff09<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>cd \/Users\/sanrosang\/Documents\/ragflow-main\nsource .venv\/bin\/activate\nexport PYTHONPATH=$(pwd)\nexport SANDBOX_ENABLED=1\nexport SANDBOX_HOST=127.0.0.1\npython api\/ragflow_server.py<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">4. \u542f\u52a8\u524d\u7aef<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>cd web\nnpm install\nnpm run dev<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">5. code \u7ec4\u4ef6\u53c2\u6570\u540d\u8981\u548c\u4ee3\u7801\u4e00\u81f4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>def main(a1: str, a2: str) -&gt; str:\n    return f\"result: {a1 + a2}\"<\/code><\/pre>\n\n\n\n<p>\u6216\u8005\u628a code \u7ec4\u4ef6\u8f93\u5165\u53c2\u6570\u540d\u6539\u6210 <code>arg1, arg2<\/code>\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u7ed3\u8bed\uff1a\u672c\u5730\u8dd1\u901a\u7684\u201c\u771f\u76f8\u201d<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6c99\u7bb1\u80fd\u7528\u7684\u672c\u8d28<\/strong>\uff1a\u540e\u7aef\u670d\u52a1\u7684\u73af\u5883\u53d8\u91cf <code>SANDBOX_ENABLED=1<\/code> \u548c <code>SANDBOX_HOST=127.0.0.1<\/code> \u5fc5\u987b\u8bbe\u7f6e\u5bf9\u3002<\/li>\n\n\n\n<li><strong>code \u7ec4\u4ef6\u80fd\u7528\u7684\u672c\u8d28<\/strong>\uff1a\u53c2\u6570\u540d\u5fc5\u987b\u548c\u4ee3\u7801\u4e00\u81f4\uff0c\u6c99\u7bb1\u670d\u52a1\u7aef\u53e3\u4e0d\u80fd\u51b2\u7a81\u3002<\/li>\n\n\n\n<li><strong>\u542f\u52a8\u987a\u5e8f\u4e0d\u662f\u7edd\u5bf9\uff0c\u4f46\u5148\u8d77\u4f9d\u8d56\u548c\u6c99\u7bb1\u66f4\u5bb9\u6613\u6392\u67e5\u95ee\u9898\u3002<\/strong><\/li>\n\n\n\n<li><strong>\u6240\u6709 export \u53ea\u5bf9\u5f53\u524d shell \u6709\u6548\uff0c\u6362\u7a97\u53e3\u8981\u91cd\u6765\u3002<\/strong><\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\u201c\u672c\u5730\u80fd\u8dd1\u901a\uff0c\u9760\u7684\u4e0d\u662f\u8fd0\u6c14\uff0c\u662f\u5bf9\u6bcf\u4e00\u4e2a\u7ec6\u8282\u7684\u6b7b\u78d5\u548c\u7406\u89e3\u3002\u201d<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>\u795d\u4f60\u5c11\u8e29\u5751\uff0c\u591a\u559d\u6c34\uff0cdebug \u4e00\u8def\u7eff\u706f\uff01<\/strong><br>\u5982\u6709\u65b0\u5751\uff0c\u6b22\u8fce\u968f\u65f6\u6765\u95ee\uff01<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u201c\u672c\u5730\u80fd\u8dd1\u901a\uff0c\u624d\u662f\u771f\u7684\u901a\u3002\u2014\u2014 &#46;&#46;&#46;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[81,80,78,79],"tags":[73,75,77],"class_list":["post-2554","post","type-post","status-publish","format-standard","hentry","category-ai","category-docker","category-ragflow","category-79","tag-ai","tag-rag","tag-77"],"_links":{"self":[{"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/posts\/2554","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/comments?post=2554"}],"version-history":[{"count":1,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/posts\/2554\/revisions"}],"predecessor-version":[{"id":2555,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/posts\/2554\/revisions\/2555"}],"wp:attachment":[{"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/media?parent=2554"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/categories?post=2554"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sanlangcode.com\/index.php\/wp-json\/wp\/v2\/tags?post=2554"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}