演示地址: https://docker-yapi.herokuapp.com/ (管理员账号:admin@docker.yapi
,管理员密码:adm1n
)。仅供测试,服务每次部署都会重置,请不要将重要数据放在上面。
你得确保在你的设备上安装了不是太老版本的 Docker
和 Docker Compose
。
首先,克隆本项目:
git clone https://github.com/fjc0k/docker-YApi.git
接下来,修改 docker-compose.yml
中 yapi-web
下的环境变量 YAPI_ADMIN_ACCOUNT
为你的管理员邮箱,YAPI_ADMIN_PASSWORD
为你的管理员密码。
最后,执行 docker-compose up -d
启动服务。
然后,通过 http://localhost:40001
即可访问 YApi
。
为了减少二次配置,docker-YApi
新增了 adminPassword
选项以设置管理员密码。
config.json
是 YApi 官方支持的配置文件,config.js
是 docker-YApi
扩展支持的配置文件,其实就是将 JSON 数据写成了更简洁的 JavaScript 对象。
你可通过将外部的 config.json
或 config.js
配置文件映射进容器内部来使用它们:
./config.json:/yapi/config.json
./config.js:/yapi/config.js
通过环境变量配置的选项会覆盖通过 config.json
或者 config.js
配置的选项。
环境变量名称 | 类型 | 说明 | 示例 |
---|---|---|---|
YAPI_ADMIN_ACCOUNT | string | 管理员账号(邮箱) | admin@foo.bar |
YAPI_ADMIN_PASSWORD | string | 管理员密码 | adm1n |
YAPI_CLOSE_REGISTER | boolean | 是否关闭注册,关闭注册后可通过插件 yapi-plugin-add-user 新增用户 | true |
YAPI_NPM_REGISTRY | string | npm 源,目前仅在安装插件时使用,默认官方源,国内可以设为淘宝源加速 | https://registry.npm.taobao.org |
环境变量名称 | 类型 | 说明 | 示例 |
---|---|---|---|
YAPI_DB_SERVERNAME | string | MongoDB 服务地址 | yapi-mongo |
YAPI_DB_PORT | number | MongoDB 服务端口 | 27017 |
YAPI_DB_DATABASE | string | 使用的 MongoDB 数据库 | yapi |
YAPI_DB_USER | string | 登录 MongoDB 服务的用户名 | root |
YAPI_DB_PASS | string | 登录 MongoDB 服务的用户密码 | r00t |
YAPI_DB_AUTH_SOURCE | string | MongoDB 身份认证所用库 | admin |
YAPI_DB_CONNECT_STRING | string | 使用 MongoDB 集群时配置 | mongodb://127.0.0.100:8418,127.0.0.101:8418/yapidb?slaveOk=true |
YAPI_DB_OPTIONS | json | Mongoose 连接 MongoDB 服务时的额外选项,一般不用设置。请参考: Mongoose.prototype.connect() | {} |
环境变量名称 | 类型 | 说明 | 示例 |
---|---|---|---|
YAPI_MAIL_ENABLE | boolean | 是否启用 | true |
YAPI_MAIL_HOST | string | 邮件服务地址 | smtp.163.com |
YAPI_MAIL_PORT | number | 邮件服务端口 | 465 |
YAPI_MAIL_FROM | string | 发送人邮箱 | foo@163.com |
YAPI_MAIL_AUTH_USER | string | 登录邮件服务的用户名 | bar@163.com |
YAPI_MAIL_AUTH_PASS | string | 登录邮件服务的用户密码 | f00bar |
YAPI_MAIL_OPTIONS | json | 传递给 Nodemailer 的额外选项,一般不用设置。请参考:Nodemailer > SMTP transport | {"tls":{"rejectUnauthorized":false}} |
点击查看 YApi 仓库下 LDAP 相关的 issues 👉
环境变量名称 | 类型 | 说明 | 示例 |
---|---|---|---|
YAPI_LDAP_LOGIN_ENABLE | boolean | 是否启用 | true |
YAPI_LDAP_LOGIN_SERVER | string | LDAP 服务地址 | ldap://ldap.foo.bar |
YAPI_LDAP_LOGIN_BASE_DN | string | 登录 LDAP 服务的用户名 | cn=admin,dc=foo,dc=bar |
YAPI_LDAP_LOGIN_BIND_PASSWORD | string | 登录 LDAP 服务的用户密码 | f00bar |
YAPI_LDAP_LOGIN_SEARCH_DN | string | 查询用户数据的路径 | ou=users,dc=foo,dc=bar |
YAPI_LDAP_LOGIN_SEARCH_STANDARD | string | 支持两种值: 1、前端登录账号对应的查询字段,如: mail 、uid 等;2、自定义查询条件,其中 %s 会被前端登录账号替换,如:&(objectClass=user)(cn=%s) |
- |
YAPI_LDAP_LOGIN_EMAIL_POSTFIX | string | 登录邮箱后缀 | @163.com |
YAPI_LDAP_LOGIN_EMAIL_KEY | string | LDAP 数据库存储用户邮箱的字段 | |
YAPI_LDAP_LOGIN_USERNAME_KEY | string | LDAP 数据库存储用户名的字段 | name |
环境变量名称 | 类型 | 说明 | 示例 |
---|---|---|---|
YAPI_PLUGINS | json | 要使用的插件列表。点击查看开源 YApi 插件列表→ 配置项数据格式: { "name": "插件名称", "options": "插件配置" } 注意: 安装插件会运行 YApi 自带的打包命令,其内存消耗较大,因此,在安装插件时,物理机可用内存最好大于 1GB ,否则,易出现内存溢出错误,导致插件安装失败。 |
[{"name":"add-user"},{"name":"gitlab","options":{}}] |
若你修改了配置,务必重启应用才能生效:
docker-compose restart yapi-web
若 YApi
有更新,本项目应会尽快跟进,之后,你可使用以下命令升级:
docker-compose pull yapi-web \
&& docker-compose down \
&& docker-compose up -d
升级不会对原有数据造成任何影响!
如果出现意外情况,你可通过以下命令查看运行日志:
docker-compose logs yapi-web
直接打包整个目录去新的服务器即可。
Jay Fong © MIT