--with-http_stub_status_module
nginx
和resty
命令配置到环境变量中, 使用nginx -v
和resty -v
能正常输出。Orange有两个配置文件,一个是conf/orange.conf
,用于配置插件、存储方式和内部集成的默认Dashboard,另一个是conf/nginx.conf
用于配置Nginx(OpenResty).
orange.conf的配置如下,请按需修改:
{
"plugins": [ //可用的插件列表,若不需要可从中删除,系统将自动加载这些插件的开放API并在7777端口暴露
"stat",
"monitor",
"redirect",
"rewrite",
"rate_limiting",
"property_rate_limiting",
"basic_auth",
"key_auth",
"signature_auth",
"waf",
"divide",
"kvstore"
],
"store": "mysql",//目前仅支持mysql存储
"store_mysql": { //MySQL配置
"timeout": 5000,
"connect_config": {//连接信息,请修改为需要的配置
"host": "127.0.0.1",
"port": 3306,
"database": "orange",
"user": "root",
"password": "",
"max_packet_size": 1048576
},
"pool_config": {
"max_idle_timeout": 10000,
"pool_size": 3
},
"desc": "mysql configuration"
},
"dashboard": {//默认的Dashboard配置.
"auth": false, //设为true,则需用户名、密码才能登录Dashboard,默认的用户名和密码为admin/orange_admin
"session_secret": "y0ji4pdj61aaf3f11c2e65cd2263d3e7e5", //加密cookie用的盐,自行修改即可
"whitelist": [//不需要鉴权的uri,如登录页面,无需修改此值
"^/auth/login$",
"^/error/$"
]
},
"api": {//API server配置
"auth_enable": true,//访问API时是否需要授权
"credentials": [//HTTP Basic Auth配置,仅在开启auth_enable时有效,自行添加或修改即可
{
"username":"api_username",
"password":"api_password"
}
]
}
}
conf/nginx.conf里是一些nginx相关配置,请自行检查并按照实际需要更改或添加配置,特别注意以下几个配置:
allow/deny
指定配置黑白名单ipstart.sh
用来启动Orangestart.sh
编写符合自己需要的类似脚本make install
来安装。 执行此命令后, 以下两部分将被安装:/usr/local/orange #orange运行时需要的lua文件
/usr/local/bin/orange #orange命令行工具, 依赖`resty`命令
如已使用Makefile安装Orange, 则执行orange help
查看有哪些命令可以使用:
Usage: orange COMMAND [OPTIONS]
The commands are:
start Start the Orange Gateway
stop Stop current Orange
reload Reload the config of Orange
restart Restart Orange
store Init/Update/Backup Orange store
version Show the version of Orange
help Show help tips
根据以上两种方式选择使用sh start.sh
或orange start
来启动Orange。 Orange启动成功后, Dashboard和API server也随之启动:
http://localhost:9999
访问7777
端口监听,如不需要API Server可删除nginx.conf里对应的配置