diff --git a/common/manual/server_config/rhymix-nginx-help.md b/common/manual/server_config/rhymix-nginx-help.md new file mode 100644 index 000000000..6ce97fb20 --- /dev/null +++ b/common/manual/server_config/rhymix-nginx-help.md @@ -0,0 +1,178 @@ +#Nginx 리라이트 설정하기 +##개요 +**Rewrite**는 주로 짧은 주소를 구현하기 위해 사용됩니다. 예를 들자면 + + https://example.com/index.php?mid=freeboard&document_srl=181 + +이라는 복잡한 주소를 + + https://example.com/freeboard/181 + +처럼 **사람이 읽고 인식하기에 편한 주소로 바꾸어 주는 기능을 담당**합니다. + +아파치의 경우 .htaccess 파일에서 mod_rewrite 모듈을 이용하여 리라이트를 할 수 있습니다. 하지만 엔진엑스의 경우 엔진엑스의 설정 파일을 수정해야 리라이트를 진행할 수 있습니다. 하지만 **절대 어렵지 않으니** 걱정하실 필요 없습니다. + +## 요약 +**적용하기** 부터는 상세하게 설명하게 됩니다. 상세하게 설명하면 실제로는 전혀 어렵지 않은 이야기를 어렵게 설명하거나, 길이 때문에 지레 포기하는 경우가 생기기 때문에 간략하게 세줄 요약하도록 하겠습니다. + +1. 엔진엑스의 설정 파일을 열고 +2. rhymix-nginx.conf 파일을 인클루드 하고 +3. 엔진엑스 재시작 + +## 적용하기 (개관) +엔진엑스의 설정 파일은 우분투를 기준으로 하여 apt-get으로 설치했다면 + + /etc/nginx/nginx.conf + +에 존재합니다. 대부분의 경우 **/etc/nginx.conf** 혹은 **/usr/local/nginx/nginx.conf**입니다. + +만약 자신의 엔진엑스의 설정 파일이 어디에 있는지 모른다면 아래와 같은 커맨드를 입력하여 엔진엑스의 설정파일을 찾을 수 있습니다. 이 커맨드는 **관리자 권한**을 이용하여 **nginx.conf**라는 **이름**을 가진 파일을 **찾으라**는 명령어입니다. 검색이 완료될 때 까지는 **엄청나게** 긴 시간이 필요하니 기다리도록 합시다. + + # sudo find / -name nginx.conf + +명령어의 결과는 아래와 같은 형식으로 출력됩니다. + + /etc/nginx/nginx.conf + +눈치 채셨겠지만, nginx.conf가 위치하고 있는 디렉터리의 경로입니다. + +또한, nginx.conf를 수정하기 위해서는 nginx.conf를 수정할 수 있는 에디터가 필요합니다. 따라서 초보자가 가장 사용하기 좋은 'nano'를 설치해 보도록 하겠습니다. + + # apt-get install nano + +이 명령어를 이용하면 nano 에디터를 설치할 수 있습니다. 물론 익숙한 에디터가 있다면 익숙한 에디터를 이용하도록 합시다. + +이제 본격적으로 nginx.conf를 편집해 보도록 하겠습니다. 먼저, rhymix에서 사용되는 php 쿼리 주소들을 정리한 파일이 필요합니다. 해당 파일을 만든 뒤에 nginx.conf에 인클루드 함으로서 리라이트를 진행해 보도록 하겠습니다. + +먼저 nano의 기본적인 조작법을 알아볼 필요가 있습니다. 더 강력한 조작법이 분명히 있지만, 굳이 이번 가이드에서는 다루지 않겠습니다. + +1. ctrl + o #저장 +2. ctrl + x #닫기 +3. 화살표 키 #커서 이동 + +이 매뉴얼과 같은 디렉터리에 존재하는 'rhymix-nginx.conf' 파일을 nginx.conf가 위치한 디렉터리(/etc/nginx)로 이동해 보도록 합시다. + + [주석입니다. sudo mv (원본 디렉터리) (옮길 디렉터리)] + # sudo mv /(RhymiX의 설치 디렉터리)/common/manual/server_config/rhymix-nginx.conf /etc/nginx/ + +이제 **nginx.conf** 파일을 수정해 보도록 하겠습니다. rhymix-nginx.conf 파일을 **nginx.conf** 파일에 인클루드 하는 첫번째 과정입니다. + +먼저 **nginx.conf** 파일을 열어줍니다. (이때, 엔진엑스에서 가상 서버 기능을 사용하고 있는 경우에는 각 서버의 설정 파일을 수정해 줘야 합니다.) + + nano nginx.conf + +nginx.conf 설정 파일을 여실 수 있을겁니다. 설정 파일에는 크게 두가지 **블럭**이 존재합니다. 첫번째는 **http{ }** 형태로 구성되어 있는 **http 블럭**, 두번째는 **server{ }** 형태로 존재하는 **server 블럭** 입니다. 리눅스 배포판에 따라서 **nginx.conf** 파일에 **server 블럭**이 없을수도 있습니다. **nginx.conf** 파일은 + + http { + server {} + } +내지는, + + http { + } + +위와 같이 구조가 짜여있는걸 확인하실 수 있습니다.(물론 event, worker_processes와 같은 부분도 있습니다만, 이 부분은 여기서 다루지 않겠습니다.) + +## 적용하기 (가상 호스트 설정) + +엔진엑스는 특정 폴더를 인클루드 함으로서 보다 간편하게 사이트를 사용할 수 있습니다. 아래의 nginx.conf는 우분투의 기본 nginx.conf입니다. + + http { + (...중략...) + + # /etc/nginx/conf.d** 디렉터리 내에 있는 .conf 확장자를 모두 인클루드 하며, **/etc/nginx/site-enabled**에 들어 있는 모든 파일을 인클루드 한다 + include /etc/nginx/conf.d/*.conf; + include /etc/nginx/site-enabled/*; + } + +**만약 include 구문이 없다면, 가이드의 한 항목 아래로 갑니다** + +site-enabled 디렉터리에 아래와 같은 서버 설정을 작성합니다. 용도에 따라서 서버 파일의 내용은 얼마든지 바뀔 수 있습니다. 아래 서버 파일은 + +1. 80 포트를 이용하여 보안 연결 없는 일반 HTTP 연결을 하고 +2. example.com 도메인을 사용하며 +3. /var/www/html 디렉터리에 RhymiX 파일이 위치하고 +4. site-enabled 디렉터리에 위치한 파일입니다. + +파일의 이름은 'example.conf'라고 가정하도록 하겠습니다. + + server { + #만약 SSL을 사용하고 싶다면 80; 대신 443 ssl;을 이용하면 됩니다. SSL을 이용하는 경우 추가적인 설정이 필요하므로, 관련 팁을 참조하시기 바랍니다. + listen 80; + + #example.com은 자신의 도메인으로 바꾸면 됩니다. www.example.com과 example.com이 서로 다름에 유의해 주세요. + server_name example.com; + + #이때, 원하는 디렉터리로 홈 디렉터리를 수정해도 됩니다. 만약 /var/lol/lol로 홈 디렉터리를 사용하고 싶다면 /var/lol/lol;을 홈 디렉터리로 사용하면 됩니다. + root /var/www/html; + + #index.php가 기본 페이지가 된다는 의미입니다. Rhymix는 index.php를 사용하니 index.php를 넣는 것입니다. + index index.php; + + #위에서 설명드렸다시피 rhymix의 리라이트 규칙을 인클루드 하는 코드입니다. + include /etc/nginx/rhymix-nginx.conf; + + } + +가상 호스트 설정 파일에 include /etc/nginx/rhymix-nginx.conf 파일을 인클루드 하도록 합니다. + +혹은, 추가하는 include 구문을 아래와 같이 추가할 수도 있지만, **절대로 이런 방식으로 추가해서는 안됩니다.** **반면교사를 위한 보여주기입니다.** + + include /RhymiX_설치경로/common/manual/server_config/rhymix-nginx.conf; + +RhymiX의 설치 경로가 **/var/www/html**이라면, + + include /var/www/html/common/manual/server_config/rhymix-nginx.conf; + +를 추가하면 됩니다. 하지만, 위와 같은 형식의 추가는 웹서버의 디렉터리를 참조하기 때문에 rhymix-nginx.conf 파일이 변조되었을 때 nginx의 rewrite 설정도 함께 바뀌기 때문에 **절대로 사용해서는 안됩니다.** + +## 만약 가상호스트 설정이 되어 있지 않다면 +만약 nginx.conf에 위와 비슷한 경로를 인클루드하는 구문이 **없다면** 추가 해 주도록 합시다. 핵심은 **경로를 인클루드 하는 것**입니다. + + +대부분의 리눅스 배포판에서는 server 블럭이 nginx.conf에 존재하지 않습니다. 따라서 특정 경로를 인클루드 하는 구문을 **추가하기만 하면 됩니다.** 이때, **nginx.conf**에 **server {} 블럭이 존재하면 에러가 발생할 수도 있습니다.** 따라서 **인클루드 구문을 없었는데 추가했다면** server 블럭을 찾아서 삭제해주도록 합니다. 예시를 들어 보여드리겠습니다. + + + # 보통 이런 형태지만.... + http { + (...중략...) + } + + # 원래 존재하던 conf 파일이 이런 형태일수도 있다... + http { + (...중략...) + server { + (...생략...) + } + } + + #이렇게 바꿔주자! + http { + (...중략...) + + include /etc/nginx/conf.d/*.conf; + include /etc/nginx/site-enabled/*; + } + +**include 구문이 없었는데 추가한 경우라면** 명령어를 이용해서 추가한 인클루드 구문의 디렉터리를 생성해 주도록 합시다. + + # sudo mkdir /etc/nginx/conf.d + # sudo mkdir /etc/nginx/site-enabled + +이 이후는 위에서 보신것과 마찬가지로 **site-enabled** 디렉터리에 서버 설정을 추가하는 과정입니다. 위쪽 가이드로 돌아가서 마저 따라하도록 합시다. + +##엔진엑스 재시작하기 +엔진엑스의 기본적인 설정을 마쳤습니다. 이제 엔진엑스가 변경된 설정을 로딩할 수 있도록 재시작해줘야 합니다. + +터미널을 열고 + + # sudo service nginx reload + +혹은 + + # sudo service nginx restart + +커맨드를 실행하도록 합니다. 이 커맨드는 **nginx**라는 **서비스**를 **리로드 하거나 재시작** 하도록 하라는 의미를 담고 있습니다. 보통 reload를 권장하며, restart는 권장하지 않습니다. + +##마치며... +이로서 엔진엑스의 리라이트 설정을 마쳤습니다. 이를 통해 읽기 복잡한 긴 주소를 짧은 주소로 변환할 수 있을 것입니다. diff --git a/common/manual/server_config/rhymix-nginx.conf b/common/manual/server_config/rhymix-nginx.conf new file mode 100644 index 000000000..1c6920eb7 --- /dev/null +++ b/common/manual/server_config/rhymix-nginx.conf @@ -0,0 +1,45 @@ +# conf, query, schema, skins, layouts, m.layouts +rewrite ^/(modules|addons|widgets|(m\.)?layouts)/(.+)\.(html|xml)$ /index.php last; + +# reserve setting files +rewrite ^/files/config/(.+)\.php$ /index.php last; + +# static files +rewrite ^/(.+)/files/(member_extra_info|attach|cache|faceOff)/(.*) /files/$2/$3 last; +rewrite ^/(.+)/(files|modules|widgets|widgetstyles|layouts|m.layouts|addons)/(.*) /$2/$3 last; + +# rss, blogAPI +rewrite ^/(rss|atom)$ /index.php?module=rss&act=$1 last; +rewrite ^/([a-zA-Z0-9_]+)/(rss|atom|api)$ /index.php?mid=$1&act=$2 last; +rewrite ^/([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)/(rss|atom|api)$ /index.php?vid=$1&mid=$2&act=$3 last; + +# trackback +rewrite ^/([0-9]+)/(.+)/trackback$ /index.php?document_srl=$1&key=$2&act=trackback last; +rewrite ^/([a-zA-Z0-9_]+)/([0-9]+)/(.+)/trackback$ /index.php?vid=$1&document_srl=$2&key=$3&act=trackback last; + +# administrator page +rewrite ^/admin/?$ /index.php?module=admin last; + +# document category +rewrite ^/([a-zA-Z0-9_]+)/category/([0-9]+)$ /index.php?mid=$1&category=$2 last; + +# document permanent link +rewrite ^/([0-9]+)$ /index.php?document_srl=$1 last; + +# mid link +rewrite ^/([a-zA-Z0-9_]+)/?$ /index.php?mid=$1 last; + +# mid + document link +rewrite ^/([a-zA-Z0-9_]+)/([0-9]+)$ /index.php?mid=$1&document_srl=$2 last; + +# vid + mid link +rewrite ^/([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)/?$ /index.php?vid=$1&mid=$2 last; + +# vid + mid + document link +rewrite ^/([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)/([0-9]+)$ /index.php?vid=$1&mid=$2&document_srl=$3 last; + +# mid + entry title +rewrite ^/([a-zA-Z0-9_]+)/entry/(.+)$ /index.php?mid=$1&entry=$2 last; + +# vid + mid + entry title +rewrite ^/([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)/entry/(.+)$ /index.php?vid=$1&mid=$2&entry=$3 last;