메뉴얼:데비안이나 우분투에서 미디어위키 구동하기

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 98% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎日本語 • ‎한국어 • ‎polski • ‎русский • ‎中文


설치 가이드Manual:Installation guide
FreeBSDManual:Running MediaWiki on FreeBSD
GNU/LinuxManual:Running MediaWiki on GNU/Linux
- ALT LinuxManual:Running MediaWiki on ALT Linux
- Arch LinuxManual:Running MediaWiki on Arch Linux
- DamnsmalllinuxManual:Running MediaWiki on Damnsmalllinux
- Debian or UbuntuManual:Running MediaWiki on Debian or Ubuntu
- FedoraManual:Running MediaWiki on Fedora
- GentooManual:Running MediaWiki on Gentoo Linux
- MandrivaManual:Running MediaWiki on Mandriva
- Red Hat Enterprise LinuxManual:Running MediaWiki on Red Hat Linux
- SlackwareManual:Running MediaWiki on Slackware Linux
Mac OS XManual:Running MediaWiki on Mac OS X
NetWareManual:Running MediaWiki on NetWare
SolarisManual:Running MediaWiki on Solaris
- Solaris 11 / opensolarisManual:Running MediaWiki on Solaris 11 / opensolaris
- Solaris 10Manual:Running MediaWiki on Solaris 10
WindowsManual:Running MediaWiki on Windows
- Windows Server 2016Manual:Installing MediaWiki on Windows Server 2016
on a stickManual:Wiki on a stick
- Uniform ServerManual:Installation on Uniform Server (Windows)
- XAMPPManual:Installing MediaWiki on XAMPP
Sourceforge.netManual:Installing MediaWiki on SourceForge.net
This page documents how to install MediaWiki using the release tarballs. If you want to use system packages, see User:Legoktm/Packages.

이 페이지는 우분투에 미디어위키를 어떻게 설치하는지 설명합니다. 이 설명은 데비안용이지만, 별도의 경고가 없는 경우 우분투와 라즈비안에서도 적용 가능합니다.

이 설치 과정은 터미널에서 명령 실행(예: 응용 프로그램 설치)이나 텍스트 편집기 (GUI: gedit, kate; TEXT: nano, emacs, vi)사용에 대한 지식을 요구합니다.

텍스트 편집이 필요한 경우에는 GUI 환경에서 Alt-F2를 누른 후 다음과 같이 입력합니다.

    gksudo gedit 파일명

또는 터미널에서 편집이 가능합니다.

    sudo nano 파일명

물론, gedit대신 kate를 사용하거나 nano대신 vi 를 사용 해도 됩니다.

단계별 설치법

우분투 업데이트 확인

아래의 두 명령어를 사용하여 우분투의 최신 버전 여부를 확인합니다.

sudo apt-get update
sudo apt-get upgrade

LAMP스택 설치

우분투 서버 에디션은 설치 과정중 LAMP (Apache, PHP, 그리고 MySQL)의 설치를 가능하게 합니다. 설치 과정중, 반드시 LAMP의 설치를 고르세요. 또는, 다음의 명령어를 사용하여 일반 우분투에서 이러한 모든 패키지를 설치할 수 있습니다.

우분투 16.04.2 LTS (지니얼)과 데비안 스트레치는 php7.0을 포함하고 있으며, 많은 패키지들의 이름이 'php5'에서 단순한 'php'로 바뀌었습니다. 또한 일부 php 모듈은 별도의 패키지로 설치해야 합니다. (xml, mbstring 등)
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
우분투 트러스티와 데비안 제시, 그리고 라즈비안(제시)는 php5를 포함하고 있으며, 대부분의 페키지에서 (전부는 아닙니다)'php5'를 사용하고 있습니다.
sudo apt-get install apache2 mysql-server php5 php5-mysql libapache2-mod-php5

선택사항. 유용한 패키지들

이 패키지들은 필수는 아니나 설치에 따라 유용할 수 있습니다.

이름 페키지 설명
대체 PHP 캐시 php-apcu or php5-apcu 최신 미디어위키 버전은 이것이 자동적으로 설치되어 당신에게 향상된 기능으로 이점을 제공할 것입니다.
PHP 유니코드 통일화. php-intl or php5-intl 사용 불가할 경우 미디어위키는 PHP동작이 느려질 것입니다.
ImageMagick imagemagick 이미지 썸네일 관리.
Inkscape inkscape SVG썸네일의 ImageMagick대체제. 일부 경우에 대해 Inkscape에서 원래 생성된 경우 SVG를 더욱 빠르게 렌더링 해낼것입니다.
PHP GD library php-gd or php5-gd 섬네일 이미지 ImageMagick의 대안.
PHP command-line php-cli or php5-cli 유지, 보수 스크립트 작성과 디버깅에 유용한 커맨드 라인의 PHP명령을 실행시킬 도구.

위의 페키지들은 다음의 명령어로도 설치가 가능합니다. sudo apt-get install packagename

미디어위키 설치

다운로드는 브라우저를 이용 하거나, 아래의 명령어를 이용할 수 있습니다.

    cd Downloads
    wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.0.tar.gz
  • 당신의 웹 디렉토리에 압축을 풉니다.
tar -xvzf /pathtofile/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki

MySQL 설정

일반 설정

이 작업은 만약 당신이 MySQL 설치중 mysql 루트 암호를 생성했을 경우 필수적으로 요구되지 않습니다.

첫째, mysql의 루트 암호를 설정합니다. 시스템 루트와 mysql루트 암호를 서로 동일하게 만들지 마세요. bash(명령 행 쉘)가 명령어 기록을 남기지 않도록 다음 명령어들을 한칸 띄우고 입력하세요.

 mysqladmin -u root password "enter the new password here"
경고 경고: 이 사용자(루트)와 비밀번호가 당신이 미디어위키를 설정할때 필요하다는 것을 기억하십시오.

보안 설정

"mysql_secure_installation의 레퍼런스 실행 메뉴얼을 고려하십시오."

메인 페이지에서:
이 프로그램은 다음과 같은 방법으로 MySQL 설치의 보안을 향상시켜줄 수 있습니다 :
  • 루트 개정용 암호를 설정할 수 있습니다.
  • 로컬 호스트 외에 접근 가능한 루트 개정을 제거할 수 있습니다.
  • 익명 사용자 개정을 제거할 수 있습니다.
  • 테스트 데이터베이스와 모두가 test_로 시작하는 이름의 데이터베이스에 접근 허용할 권한을 제거 가능합니다.(일반 사용자 뿐만 아니라 익명 사용자도 접근 가능한 DB입니다.)
    mysql_secure_installation

선택 사항: PHP 설정

이 작업은 선택 사항이며, 설치 후에도 가능합니다. 미디어위키는 이러한 변화 없이도 여전히 작동할 것입니다.

당신의 PHP설정파일, php.ini를 수정하세요. 우분투 트러스티와 데비안 제시의 경우, /etc/php5/apache2/php.ini에 위치해 있습니다.

On Ubuntu Xenial and Debian Stretch (PHP 7), it is located at /etc/php/7.0/apache2/php.ini.

최대 업로드 파일 크기

위키에 다양한 종류의 파일을 업로드하고자 한다면, 최대 파일 업로드 제한 용량을 조절해야 합니다. 대략 스크롤의 절반쯤에 파일 업로드 섹션이 위치합니다. 수정:

upload_max_filesize = 2M

에서 최소 20M으로. 더 큰 업로드를 원할 경우, 나중에 다시 조정할 수 있습니다.

메모리 제한

어떤 PHP 스크립트는 작동을 위해 상당한 메모리를 요구합니다. 스크립트가 한번에 사용할 수 있는 용량을 늘리기 위해, 페이지를 약 21% 가량 스크롤 해 다음 내용을 찾아 수정합니다.

memory_limit = 8M

->

memory_limit = 128M

만약 이미 128M나 그 이상으로 설정 되 있을 경우, 그대로 저장하시면 됩니다.

미디어위키 설정

당신의 브라우저로 http://localhost (어떤 설치에선 http://localhost/mediawiki/confighttp://wiki.hostname.com/config 일 수 있습니다)에 접속하세요. 그리고 주어진 절차를 따르세요.

만약 404에러를 출력할 경우, 다음으로 해결이 가능할 것입니다:

cd /var/www/html
sudo ln -s /var/lib/mediawiki mediawiki
  • 미디어위키 설치 스크립트의 사용 환경 검사부분을 확인하세요. ('미디어위키에 오신 것을 환영합니다!'부분에서 확인 가능)

이것으로 에러를 일으키는 특정한 원인들을 식별하여 많은 문제들을 해결 가능합니다.

당신이 설치를 이미 완료했음에도 mbstring이나 xml같은 php확장기능을 요구할 수 있습니다. 다음을 이용하여 직접 그것들을 활성화 시키세요:

 sudo phpenmod mbstring
 sudo phpenmod xml
 sudo systemctl restart apache2.service

설정 양식을 체우고, 계속해서 진행 해 주세요.

데이터베이스 설정에서, 당신은 데이터베이스 이름이나 DB사용자 이름을 새로운 값으로 바꿀 수 있습니다만, 반드시 "최고 관리자 계정"을 다음과 같이 활성화해야 합니다. :

debian-sys-maint

당신이 전에 설정했던 mysql의 루트 비밀번호를 입력합니다.

설치 과정은 당신에게 새로운 위키의 상위 디렉토리에 저장되어있을 LocalSettings.php를 다운로드 하라 요구할 것입니다. 설정 페이지는 다음의 위치로 옮겨져야 할 정확한 디렉토리와 파일명을 보여줄 것입니다.

 sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/

그리고 브라우저를 통해 http://localhost/mediawiki (혹은 http://server_ip_address/mediawiki 혹은 http://server_ip_address/mediawiki/index.php)로 이동하여 당신의 새로운 위키를 볼 수 있을 것입니다.

완성! 이제 당신은 당신만의 위키를 열었습니다.

추가적인 위키 설정

기본 정보

미디어위키는 LocalSettings.php파일로 구성되어있습니다. 이 파일은 주로 /var/lib/mediawiki에서 발견할 수 있습니다. Manual:LocalSettings.php 문서는 유용하게 쓰일 수 있는 자세한 정보들을 담고 있습니다. 다음에 따른 변경은 일반적으로 도움을 줍니다.

LocalSettings.php을 편집하기 위해, 다음을 사용합니다.

gksudo gedit /var/lib/mediawiki/LocalSettings.php

혹은 터미널에서

sudo nano /var/lib/mediawiki/LocalSettings.php


파일 업로드

Manual:Configuring file uploadsManual:Configuring file uploads 참고.

로고 바꾸기

메뉴얼:$wgLogoManual:$wgLogo 참고.

미디어위키 확장기능

현재 미디어위키의 TAR파일은 약 15개쯤 되는 가장 널리 쓰이는 확장자를 포함하고 있지만, 세상에는 수백가지도 더 넘게 있습니다.

확장자를 활성화시키는 방법은 Manual:Extensions#Installing an extensionManual:Extensions#Installing an extension을 통해 알 수 있습니다.

URL 간단화

To use /wiki/* instead of /wiki/index.php/* on Debian, follow the recommended short URL guide using '/mediawiki' as the script path instead of '/w' and placing the rewrites in /etc/apache2/conf-enabled/mediawiki.conf.

관련 항목