Keldos commited on
Commit
f931ef4
1 Parent(s): b9efe2a

doc: 分离疑难杂症解决至wiki文档

Browse files
Files changed (1) hide show
  1. README.md +17 -147
README.md CHANGED
@@ -54,7 +54,7 @@
54
  - 输入框支持换行,按`shift enter`即可。
55
  - 部署到服务器:将程序最后一句改成`demo.launch(server_name="0.0.0.0", server_port=<你的端口号>)`。
56
  - 获取公共链接:将程序最后一句改成`demo.launch(share=True)`。注意程序必须在运行,才能通过公共链接访问。
57
- - 在Hugging Face上使用:建议在右上角 **复制Space** 再使用,这样
58
 
59
 
60
  ## 安装方式
@@ -162,7 +162,7 @@
162
 
163
  你可以通过本项目提供的脚本检测仓库是否有更新,如果有,则拉取最新脚本、安装依赖、重启服务器。此功能支持`Linux`和`macOS`系统。
164
 
165
- 如果你想运行,只需要运行`run_Linux.sh`或者`run_macOS`。如果你还想保持最新版本,只需要定时运行脚本。例如,在crontab中加入下面的内容:
166
 
167
  ```
168
  */20 * * * * /path/to/ChuanhuChatGPT/run_Linux.sh
@@ -210,14 +210,14 @@ docker build -t chuanhuchatgpt:latest .
210
 
211
  <details><summary>如果需要在公网服务器部署本项目,请阅读该部分</summary>
212
 
213
- ### 部署到公网服务器
214
 
215
  将最后一句修改为
216
 
217
  ```
218
  demo.queue().launch(server_name="0.0.0.0", server_port=7860, share=False) # 可自定义端口
219
  ```
220
- ### 用账号密码保护页面
221
 
222
  将最后一句修改为
223
 
@@ -225,7 +225,7 @@ demo.queue().launch(server_name="0.0.0.0", server_port=7860, share=False) # 可
225
  demo.queue().launch(server_name="0.0.0.0", server_port=7860,auth=("在这里填写用户名", "在这里填写密码")) # 可设置用户名与密码
226
  ```
227
 
228
- ### 配置 Nginx 反向代理
229
 
230
  注意:配置反向代理不是必须的。如果需要使用域名,则需要配置 Nginx 反向代理。
231
 
@@ -272,7 +272,7 @@ map $http_upgrade $connection_upgrade {
272
  为了同时配置域名访问和身份认证,需要配置SSL的证书,可以参考[这篇博客](https://www.gzblog.tech/2020/12/25/how-to-config-hexo/#%E9%85%8D%E7%BD%AEHTTPS)一键配置
273
 
274
 
275
- ### 全程使用Docker 为ChuanhuChatGPT 开启HTTPS
276
 
277
  如果你的VPS 80端口与443端口没有被占用,则可以考虑如下的方法,只需要将你的域名提前绑定到你的VPS 的IP即可。此方法由[@iskoldt-X](https://github.com/iskoldt-X) 提供。
278
 
@@ -320,152 +320,22 @@ docker run -d --name chatgpt \
320
 
321
  ## 疑难杂症解决
322
 
323
- 首先,请先尝试拉取本项目的最新更改,使用最新的代码重试。
324
 
325
- 点击网页上的 `Download ZIP` 下载最新代码,或
326
- ```shell
327
- git pull https://github.com/GaiZhenbiao/ChuanhuChatGPT.git main -f
328
- ```
329
-
330
- 如果还有问题,可以再尝试重装 gradio:
331
-
332
- ```
333
- pip install gradio --upgrade --force-reinstall
334
- ```
335
 
336
  很多时候,这样就可以解决问题。
337
 
338
- ### 常见问题
339
-
340
- <details><summary><code>配置代理</code></summary>
341
-
342
- OpenAI不允许在不受支持的地区使用API,否则可能会导致账号被风控。下面给出代理配置示例:
343
-
344
- 在Clash配置文件中,加入:
345
-
346
- ```
347
- rule-providers:
348
- private:
349
- type: http
350
- behavior: domain
351
- url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/lancidr.txt"
352
- path: ./ruleset/ads.yaml
353
- interval: 86400
354
-
355
- rules:
356
- - RULE-SET,private,DIRECT
357
- - DOMAIN-SUFFIX,openai.com,你的代理规则
358
- ```
359
-
360
- 如果你使用 Surge,请在配置文件中加入:
361
-
362
- ```
363
- [Rule]
364
- DOMAIN-SET,https://cdn.jsdelivr.net/gh/Loyalsoldier/surge-rules@release/private.txt,DIRECT
365
- DOMAIN-SUFFIX,openai.com,你的代理规则
366
- ```
367
-
368
- 另外,强烈建议打开Clash的TUN模式(Surge的增强模式),否则终端流量可能不会走代理。或者,你也可以配置HTTPS_PROXY这个环境变量,川虎ChatGPT会自动从环境变量中获取代理配置。
369
-
370
- 注意,如果你本来已经有对应的字段,请将这些规则合并到已有字段中,否则代理软件会报错。
371
-
372
- </details>
373
-
374
- <details><summary><code>找不要依赖项(No matching distribution found for tiktoken)</code></summary>
375
-
376
- 这种情况是因为你使用的`pip`源中没有这个包。pypi的镜像源(比如清华源)的更新可能没有官方源那么及时。如果遇到了这种情况,建议换用pypi的官方源:
377
-
378
- 临时换用官方源:
379
- ```
380
- pip install tiktoken -i https://pypi.org/simple
381
- ```
382
-
383
- 或者永久替换为官方源:
384
- ```
385
- pip config set global.index-url https://pypi.org/simple
386
- ```
387
-
388
- </details>
389
-
390
- <details><summary><code>TypeError: Base.set () got an unexpected keyword argument</code></summary>
391
-
392
- 这是因为川虎ChatGPT紧跟Gradio发展步伐,你的Gradio版本太旧了。请升级依赖:
393
-
394
- ```
395
- pip install -r requirements.txt --upgrade
396
- ```
397
- </details>
398
 
399
- <details><summary><code>No module named '_bz2'</code></summary>
400
-
401
- > 部署在CentOS7.6,Python3.11.0上,最后报错ModuleNotFoundError: No module named '_bz2'
402
-
403
- 安装python前先下载 `bzip` 编译环境
404
-
405
- ```
406
- sudo yum install bzip2-devel
407
- ```
408
- </details>
409
-
410
- <details><summary><code>openai.error.APIConnectionError</code></summary>
411
-
412
- > 如果有人也出现了`openai.error.APIConnectionError`提示的报错,那可能是`urllib3`的版本导致的。`urllib3`版本大于`1.25.11`,就会出现这个问题。
413
- >
414
- > 解决方案是卸载`urllib3`然后重装至`1.25.11`版本再重新运行一遍就可以
415
-
416
- 参见:[#5](https://github.com/GaiZhenbiao/ChuanhuChatGPT/issues/5)
417
-
418
- 在终端或命令提示符中卸载`urllib3`
419
-
420
- ```
421
- pip uninstall urllib3
422
- ```
423
-
424
- 然后,通过使用指定版本号的`pip install`命令来安装所需的版本:
425
-
426
- ```
427
- pip install urllib3==1.25.11
428
- ```
429
-
430
- 参考自:
431
- [解决OpenAI API 挂了代理还是连接不上的问题](https://zhuanlan.zhihu.com/p/611080662)
432
- </details>
433
-
434
- <details><summary><code>在 Python 文件里 设定 API Key 之后验证失败</code></summary>
435
-
436
- > 在ChuanhuChatbot.py中设置APIkey后验证出错,提示“发生了未知错误Orz”
437
-
438
- 参见:[#26](https://github.com/GaiZhenbiao/ChuanhuChatGPT/issues/26)
439
- </details>
440
-
441
- <details><summary><code>一直等待/SSL Error</code></summary>
442
-
443
- > 更新脚本文件后,SSLError [#49](https://github.com/GaiZhenbiao/ChuanhuChatGPT/issues/49)
444
- >
445
- > 跑起来之后,输入问题好像就没反应了,也没报错 [#25](https://github.com/GaiZhenbiao/ChuanhuChatGPT/issues/25)
446
- >
447
- > ```
448
- > requests.exceptions.SSLError: HTTPSConnectionPool(host='api.openai.com', port=443): Max retries exceeded with url: /v1/chat/completions (Caused by SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1129)')))
449
- > ```
450
-
451
- 请参考配置代理部分,将`openai.com`加入你使用的代理App的代理规则。注意不要将`127.0.0.1`加入代理,否则会有下一个错误。
452
-
453
- </details>
454
-
455
- <details><summary><code>网页提示错误 Something went wrong</code></summary>
456
-
457
- > ```
458
- > Something went wrong
459
- > Expecting value: 1ine 1 column 1 (char o)
460
- > ```
461
-
462
- 出现这个错误的原因是`127.0.0.1`被代理了,导致网页无法和后端通信。请设置代理软件,将`127.0.0.1`加入直连(具体方法见上面“一直等待/SSL Error”部分)。
463
- </details>
464
-
465
- <details><summary><code>No matching distribution found for openai>=0.27.0</code></summary>
466
-
467
- `openai`这个依赖已经被移除了。请尝试下载最新版脚本。
468
- </details>
469
 
470
  ## Starchart
471
 
 
54
  - 输入框支持换行,按`shift enter`即可。
55
  - 部署到服务器:将程序最后一句改成`demo.launch(server_name="0.0.0.0", server_port=<你的端口号>)`。
56
  - 获取公共链接:将程序最后一句改成`demo.launch(share=True)`。注意程序必须在运行,才能通过公共链接访问。
57
+ - 在Hugging Face上使用:建议在右上角 **复制Space** 再使用,这样App反应可能会快一点。
58
 
59
 
60
  ## 安装方式
 
162
 
163
  你可以通过本项目提供的脚本检测仓库是否有更新,如果有,则拉取最新脚本、安装依赖、重启服务器。此功能支持`Linux`和`macOS`系统。
164
 
165
+ 如果你想运行,只需要运行`run_Linux.sh`或者`run_macOS.command`。如果你还想保持最新版本,只需要定时运行脚本。例如,在crontab中加入下面的内容:
166
 
167
  ```
168
  */20 * * * * /path/to/ChuanhuChatGPT/run_Linux.sh
 
210
 
211
  <details><summary>如果需要在公网服务器部署本项目,请阅读该部分</summary>
212
 
213
+ #### 部署到公网服务器
214
 
215
  将最后一句修改为
216
 
217
  ```
218
  demo.queue().launch(server_name="0.0.0.0", server_port=7860, share=False) # 可自定义端口
219
  ```
220
+ #### 用账号密码保护页面
221
 
222
  将最后一句修改为
223
 
 
225
  demo.queue().launch(server_name="0.0.0.0", server_port=7860,auth=("在这里填写用户名", "在这里填写密码")) # 可设置用户名与密码
226
  ```
227
 
228
+ #### 配置 Nginx 反向代理
229
 
230
  注意:配置反向代理不是必须的。如果需要使用域名,则需要配置 Nginx 反向代理。
231
 
 
272
  为了同时配置域名访问和身份认证,需要配置SSL的证书,可以参考[这篇博客](https://www.gzblog.tech/2020/12/25/how-to-config-hexo/#%E9%85%8D%E7%BD%AEHTTPS)一键配置
273
 
274
 
275
+ #### 全程使用Docker 为ChuanhuChatGPT 开启HTTPS
276
 
277
  如果你的VPS 80端口与443端口没有被占用,则可以考虑如下的方法,只需要将你的域名提前绑定到你的VPS 的IP即可。此方法由[@iskoldt-X](https://github.com/iskoldt-X) 提供。
278
 
 
320
 
321
  ## 疑难杂症解决
322
 
323
+ 在遇到各种问题查阅相关信息前,您可以先尝试手动拉取本项目的最新更改并更新 gradio,然后重试:
324
 
325
+ 1. 点击网页上的 `Download ZIP` 下载最新代码,或
326
+ ```shell
327
+ git pull https://github.com/GaiZhenbiao/ChuanhuChatGPT.git main -f
328
+ ```
329
+ 2. 更新gradio
330
+ ```
331
+ pip install gradio --upgrade --force-reinstall
332
+ ```
 
 
333
 
334
  很多时候,这样就可以解决问题。
335
 
336
+ 如果问题仍然存在,请查阅该页面:[常见问题](https://github.com/GaiZhenbiao/ChuanhuChatGPT/wiki/常见问题)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
337
 
338
+ 该页面列出了**几乎所有**您可能遇到的各种问题,包括如何配置代理,以及遇到问题后您该采取的措施,**请务必认真阅读**。
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
339
 
340
  ## Starchart
341