매뉴얼:미디어위키 설치

This page is a translated version of the page Manual:Installing MediaWiki and the translation is 14% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎Deutsch (Sie-Form) • ‎English • ‎Türkçe • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎português • ‎português do Brasil • ‎suomi • ‎svenska • ‎čeština • ‎русский • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어


미디어위키는 대화형 웹기반 설치 스크립트를 이용하여 스스로 설치합니다. 스크립트를 실행하기 전에 몇가지 일을 해야합니다. 필요 조건 또는 설치 가이드(전문가용) 을 읽어보세요.

미디어위키는 Apache, PHP, MySQL/MariaDB 경험이 없는 일반 사용자가 설치하기는 어려울 수 있습니다. 위키를 이용하고 싶은 대부분의 사용자에게는 free MediaWiki host 또는 소프트웨어 번들을 이용하는 것이 더 효율적일 수 있습니다.

문제해결을 위해서는 Manual:Errors and symptoms#Installation Errors을 참고하세요

미디어위키 소프트웨어 다운로드

Web browser

Download the MediaWiki tar file from the official download page. Generally, if you're using a production environment, you want to be running the latest stable release, which is mediawiki-1.35.2.tar.gz.

Command line (*nix machine)

최신 안정 릴리즈 버전인 미디어위키 1.35.2을 *nix 시스템으로 다운로드 하려면 다음 명령을 사용할수 있습니다.

wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.tar.gz

Alternatively, using cURL:

curl -O https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.tar.gz

다운로드한 파일은 .tar.gz 파일 형식이며, 사용하기 전에 압축을 풀어야 합니다. This can be done locally (and then uploaded via FTP) or directly on your server. This is usually done with software such as 7-Zip (free), WinZip, WinRAR or IZArc (free) on Windows. On Linux and Mac OS X, you can untar the file using this command:

tar xvzf mediawiki-*.tar.gz
If you untar the archive as root, you should probably change the ownership afterwards with chown, otherwise the files will end up owned as user # 1000, which may or may not be what you want.

개발자들에게

Developers on the other hand should probably download from Git to set up a local repository with the latest code in development. 또한 Composer 을 통해 수동으로 종속성을 설치해야 합니다.

파일을 업로드하기

If you have not already uploaded the files to your web server, do so now.

Upload the files to your web server's web directory either by:

  1. directly copying the unzipped folder or
  1. by using an FTP client such as FileZilla (Open Source Software, Windows, OSX and Linux) or Cyberduck (Also OSS, Windows and OSX).
  1. by using cPanel File Manager (see below)

If your upload tool has a "change file names to lowercase" option, then you must disable this.

If you installed Apache, the correct directory is specified in your httpd.conf file (it's the DocumentRoot directive, typically /var/www/ or <apache-folder>/htdocs). Note: This changed in Ubuntu 14.04 with Apache 2.4.7 where the primary configuration file for Apache server settings and directories is /etc/apache2/apache2.conf.

If you are using a Linux or Unix server you can instead copy the files to any directory on your server and then make a symbolic link to that folder from your web server's web directory.

Rename the uploaded folder to whatever you would like to have in the URL. If your web server is running as http://localhost for example, renaming to /w/ directory would mean you would access your wiki at http://localhost/w/index.php. Do not use /wiki/ if you want to use it as a Short URL. (And don't set up short URLs until you have run the installation script.)

Note that in certain cases, like when a local repository is set-up using Git, on browsing to index.php the Linux server might show the "500 Internal server Error". This is possibly a permissions error which can be resolved on changing the file and directory permissions by running the following command in SSH after changing directory to "w":
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

This (renamed) folder will now be referred as <MediaWiki-folder>.

cPanel File Manager

cPanel is a popular interface used by many web hosts. This method is efficient because the files are uncompressed on the server itself.

  • Navigate to the directory where you want your wiki folder.
  • Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
  • Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
  • Confirm that the mediawiki-1.xx.x folder is present.
  • Delete the tar.gz file.
  • Rename the mediawiki-1.xx.x folder to w.

데이터베이스 만들기

If you already have a database server and know the root password for it, the MediaWiki installation script can create a new database for you. If this is the case, you can skip to the Run the installation script section below. If you don't know the root password, for example if you are on a hosted server, you will have to create a new database now. Currently, you must use SQLite, MariaDB/MySQL or PostgreSQL to store the actual contents of your wiki. If you're unsure which database to choose, use MariaDB as it is the one best supported by MediaWiki.

SQLite

SQLite is a stand-alone database library that stores the database contents in a single file. If PHP has the pdo-sqlite module, no further setup is required.

On the installation page, you will need to choose a database name (which can be anything) and the SQLite database directory. For the database directory, the installer will attempt to use a subdirectory outside of the document root and create it if needed. If this directory is not safe (for example, web-readable), change it manually to avoid making it accessible to everyone on the web.

MariaDB/MySQL

MediaWiki will ask you for database and user name and will attempt to create them if they don't already exist. If doing so from MediaWiki is impossible, you can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you.

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

If your database is not running on the same server as your web server, you need to give the appropriate web server hostname — mediawiki.example.com in the example below — as follows:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
  경고: MySQL/MariaDB on UNIX/Linux logs all queries sent to it to a file, which will include the password you used for the user account. If this concerns you, delete your .mysql_history file after running these queries. This file may be found in your home directory (~/.mysql_history).


PostgreSQL

If you are using PostgreSQL, you will need to either have a database and user created for you, or simply supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

Here's one way to do most of the setup. This is for a Unix-like system. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

 createuser -S -D -R -P -E wikiuser (저기에 비밀번호를 입력하세요)
 createdb -O wikiuser wikidb

or as superuser (default postgres) execute the following commands at the database prompt:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;

설치 스크립트 실행

Once all of the above steps are complete, you can complete the installation through a web browser by going to the index.php URL in your browser — check the instructions mentioned in 메뉴얼: 환경 설정 스크립트 .

The installation tool will prompt you to download the LocalSettings.php file, and to save this as <MediaWiki-folder>/LocalSettings.php.

Alternatively, you can run the command-line installer or CLI: php maintenance/install.php adding the appropriate configuration parameters.

Further steps

These are optional but make your site look so much better.

Keep up to date!

Once installed, make sure you stay up to date with releases, and keep your server secure!

Installation assistance

같이 보기