A command line tool, which can be used to generate nginx config file according to given config files of Apache.
NGINX (“engine x”) is a high performance web server, caching proxy and a Layer 7 load balancing solution. Millions of web sites on the Internet benefit from using NGINX because of its extreme performance, scalability, reliability, flexibility and security.
However, like Apache, the configuration of NGINX is not an easy thing for most of the people. In particularly, it will take our more efforts to learn the modules and directives in Apache and Nginx when we need to migrate to NGINX from Apache server.
According to the above requirement, we developed the apache2nginx tool. The goal of this tool is generating Nginx configuration file(s) according to those of Apache.
You can download a Linux executable (for both i386/x86_64) or compile from source. If you're on a Mac, compiling from source has been tested with OS X Yosemite.
$ wget https://github.com/downloads/nhnc-nginx/apache2nginx/apache2nginx-1.0.1-bin.i386.tar.bz2
$ tar jxvf apache2nginx-1.0.1-bin.i386.tar.bz2Now you will get the executable file apache2nginx.
you can by follow command to try use.
$ ./apache2nginx -hStep 1: Download and unzip source code to the above directory.
$ wget https://github.com/nhnc-nginx/apache2nginx/zipball/master -O nhnc-nginx-apache2nginx.zip
$ unzip nhnc-nginx-apache2nginx.zipStep 2: Configure: you could change the PREFIX by --prefix option for the installation directory
$ cd nhnc-nginx-apache2nginx
$ ./configure --prefix=/usr/local/apache2nginxStep 3: Compile and install
$ make && make installStep 4: Add apache2nginx to PATH environment variable.
$ export PATH=/usr/local/apache2nginx/bin:$PATHThe easiest way to run Apache2nginx is as below:
$ apache2nginx -f /etc/httpd/conf/httpd.confNow, if it’s ok, nginx.conf will been produced. By default, the converting result file is nginx.conf which is in the current directory.
- Manual apache2nginx_manual.pdf
- Supported Modules apache_module_support.pdf
- Module and Directive Mapping module_directive_mapping.pdf
THE AUTHOR(S) OF APACHE2NGINX SOFTWARE IS NOT LIABLE FOR ANY DAMAGES SUFFERED AS A RESULT OF USING, MODIFYING, CONTRIBUTING, OR COPYING THE SOFTWARE. THE AUTHOR(S) OF APACHE2NGINX SOFTWARE IS ALSO NOT LIABLE FOR ANY INDIRECT, INCIDENTAL, PUNITIVE, SPECIAL OR CONSEQUENTIAL DAMAGE (INCLUDING LOSS OF BUSINESS, REVENUE, PROFITS, USE, DATA OR OTHER ECONOMIC ADVANTAGE).
THE FUNCTION PROVIDED BY THIS TOOL CAN'T BE GUARANTEED AND ASSURED TO BE ACCURATE. THE PURPOSE OF DESIGNING THIS SOFTWARE IS TO HELP USERS EASILY CONVERTING THE APACHE CONFIGURATION FILES TO NGINX'S. USER SHOULD CHECK WHETHER THE CONVERTED RESULT IS EFFECTIVE OR NOT BEFORE USING IN THE PRODUCTION ENVIRONMENT.
THE APACHE2NGINX SOFTWARE CONVERTS THE APACHE CONFIGURATION FILES ACCORDING TO THE FUNCTION OF APACHE MODULES NOT THE DIRECTIVES. SO THERE AREN’T THE 1 TO 1 RELATIONS BETWEEN THE APACHE DIRECTIVES TO NGINX DIRECTIVES.