使用docker启动UI后无法访问系统或者提示服务器内部错误

可能原因： docker启动UI时设置的API_BASE_PATH无法访问后台服务。

  1. $ docker run -it --rm -p 9000:80 -e "API_BASE_PATH=http://host.docker.internal:8848/" registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd

需要将API_BASE_PATH修改为后台服务ip地址+端口。
修改API_BASE_PATH后仍未解决问题则可能是因为服务未正确启动,需要根据日志检查,查看日志: docker-compose logs jetlinks。

通过UI源码自行构建启动后无法访问系统或账号密码错误

大部分是因为前端代码中的代理后台地址配置错误
ui代理地址
修改上图中target为后台服务ip+端口即可。

使用docker启动所有环境后无法访问系统或者提示服务器内部错误

可能原因： docker启动UI时设置的API_BASE_PATH无法访问后台服务。

  1.   ui:
  2.     image: registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd:1.1.1-RELEASE
  3.     container_name: jetlinks-ce-ui
  4.     ports:
  5.       - 9000:80
  6.     environment:
  7.       - "API_BASE_PATH=http://jetlinks:8848/" #API根路径
  8.     volumes:
  9.       - "jetlinks-volume:/usr/share/nginx/html/upload"
  10.     links:
  11.       - jetlinks:jetlinks

查看项目目录docker/run-all下docker-compose.yml文件中ui的环境变量API_BASE_PATH，端口是否与后台服务端口一致，否则改之。

错误日志: elasticsearch: Name or Service not know

elasticsearch未正确启动,使用命令docker-compose logs elasticsearch查看日志,根据日志提示解决.

更换数据库

目前平台支持mysql、mssql、oracle、postgres数据库。
更换数据库（此处以mysql为例）需要注意的事项：

  1. 更换数据库地址 ``` r2dbc: url: r2dbc:mysql://localhost:3306/jetlinks
2.将application.yml中的数据库方言替换为目标方言，如：

easyorm: default-schema: jetlinks # 数据库默认的schema dialect: mysql #数据库方言

在mysql中此处default-schema应修改为mysql中存在的数据库名称，<br />
如第一步url中数据库名为jetlinks，default-schema也应为jetlinks。
若出现以下警告，应考虑mysql是否已创建相应库。<br />
![mysql-connection-warning](https://cdn.nlark.com/yuque/0/2020/png/2553045/1600226504815-e53ee386-14a3-40cf-9627-5e27abfe4c30.png)
## maven依赖问题
大部分是因为配置了全局私服，在setting.xml文件中取消即可。
## 协议发布失败或出现不支持的协议：xxx
大部分原因是后台配置的文件上传路径错误。<br />
修改配置/jetlinks-standalone/src/main/resources/application.yml：

file: upload: static-file-path: ./static/upload static-location: http://localhost:${server.port}/upload

::: tip 注意:<br />
localhost应为部署平台服务的ip地址<br />
:::<br />
若为docker启动的平台，则修改/docker/run-all/docker-compose.yml文件下的环境变量：

jetlinks: image: registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-standalone:1.0-SNAPSHOT volumes:

  - "jetlinks-volume:/static/upload"  # 持久化上传的文件
environment:
 # - "JAVA_OPTS=-Xms4g -Xmx18g -XX:+UseG1GC"
  - "hsweb.file.upload.static-location=http://127.0.0.1:8848/upload"  #上传的静态文件访问根地址,为ui的地址.

```