Skip to content

Trouble Shooting

AlexaZhou edited this page Oct 12, 2017 · 17 revisions

在安装和使用 VeryNginx 的过程中可能会遇到一些问题,下面列举了常见的问题及对应的解决方案,供参考。

Q: run "python instal.py install all" failed ?

1, 因为缺少 gcc 所以无法编译

yum install gcc

2, 缺少一些必要的库,如 openssl, PCRE,导致编译不成功

fedora / centos 下可以执行以下命令

yum install pcre pcre-devel 
yum install openssl openssl-devel 

如果你使用的是 ubuntu,那么需要

apt-get install libssl libssl-dev
apt-get install libpcre3 libpcre3-dev

3, 复制文件失败

使用 sudo 来运行安装脚本

Q: 启动失败 ?

1,nginx.conf 中指定了使用 nginx 用户来执行程序,而系统里缺少 nginx 用户,所以无法运行

adduser nginx

2,如果是使用自己的配置无法启动,那么为了排除配置问题,可以先使用 VeryNginx 自带的 nginx.conf 来运行 nginx。如果可以运行,那么说明是配置的原因。

仔细对比能工作和不能工作的配置,找到出问题的地方进行修正即可。

3,为了排除权限问题,可以使用 root 用户来运行 nginx 试试。方法是在 nginx.conf 中:

user nginx; 修改成 user root;

Q: 无法访问控制面板 / 控制面板工作不正常?

1, 可以先使用 chrome 或 safari 浏览器,排除浏览器不兼容的可能

2, VeryNginx 控制面板页面中的一些 css 和 js 库是引用了公网上的地址,如果不能访问公网,将不能正常工作。如果遇到页面显示不正常之类的问题,请打开网页调试工具,确认静态文件有没有载入成功

Q: 无法保存配置 ?

VeryNginx 的前端面版是一个单页面应用( SPA ),首先为了确定配置是否被保存,可以刷新页面重新登入控制面版,查看修改配置过的配置是否存在,如果存在,那么表示配置已经被保存了,此时配置应该被已经被保存到了 /opt/verynginx/verynginx/config/config.json 中。如果保存失败,可能有以下原因:

1,未点击保存按钮

修改配置后,页面底部会出现一个浮动条,提示保存,在点击浮动条上的保存按钮之后,配置才会进行写入

2, nginx 进程对 /opt/verynginx/verynginx/configs/ 无写权限

执行 chmod -R 777 /opt/verynginx/verynginx/configs

3, nginx 设置的 client body 太小,导致请求体被缓存到文件,导致 lua 代码没有获取到请求体,保存时会提示请求失败

在 nginx.conf 中 http 部分增加一句,client_body_buffer_size 128k;

4,nginx 以 nobody 方式运行

如果 nginx.conf 中定义了 user nobody; 将可能导致无法保存配置,去掉这项配置,或者指定成正常的用户即可

技术支持

如果看了以上,还是没有搞定 / 遇到其他问题 / 怀疑程序有 bug ?

虽然 VeryNginx 是一个免费的开源软件,但是在目前阶段,我还不能确定软件百分之百没有任何 bug 存在。所以我努力为大家提供尽可能迅速的免费技术支持服务。

如果有问题请尽管联系我,让我来帮你解决 😄

为了情况可以复现,请提供尽量详细的信息,好让问题可以快速得到响应和解决,所需要的信息包括以下内容
  • 运行 VeryNginx 的系统环境
  • VeryNginx 的安装方法( 脚本自动安装 / 手动编译安装 / 和 Tengine 一起安装等等)
  • 所使用的 Nginx 配置 / 能让故障发生的最小 nginx 配置
  • 详细的故障现象
  • Nginx access.log / error.log 片段
  • 以及其它一切你认为有用的信息

发送到: [email protected] ,我会尽可能及时的回复你

一般来说,对内容详细的邮件,我会在几小时到一天的时间里进行回复 Enjoy~