Manual:A MediaWiki telepítése
Ez a lap leírja a MediaWiki manuális telepítéséhez szükséges lépéseket. További konfigurációs lépésekhez lásd: Kézikönyv:Rendszeradminisztráció#Beállítás.
To install MediaWiki, a basic understanding of web hosting is needed. Experience with Apache, PHP, and MySQL/MariaDB will make the process easier. További segítséget a Project: Support desk lapon kérhetsz.
A függelékek szakasz hivatkozásokat tartalmaz a manuális telepítés egyszerűbb alternatíváira, valamint telepítési megjegyzésekre speciális rendszerbeállítások esetén.
For a quicker local server setup of MediaWiki, refer to the Local development quickstart.
A telepítési követelmények ellenőrzése
Check that your system meets the installation requirements.
Make sure to also check the Kiadási megjegyzések of the MediaWiki version that you plan to install.
A MediaWiki letöltése
Download the MediaWiki tar file from the official download page.
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. The current stable version is MediaWiki 1.42.3.
Extract the MediaWiki software
A letölthető állományok .tar.gz vagy .zip formátumú archívumok, vagyis használat előtt ki kell őket csomagolni.
Ez történhet helyben (később FTP-n feltöltéssel) vagy egyből a webszerveren.
Ezt Windowson például a 7-Zip (ingyenes), WinZip, WinRAR vagy IZArc (ingyenes) programokkal lehet megtenni.
Linuxon és Mac OS X-en a beépített untar módszerrel lehet őket kibontani:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> For more information on securing file permissions, refer to Manual:Security#File permissions.
Fájlok feltöltése a szerveredre
Ha még nem töltötted fel a fájlokat a webszerverre, tedd meg most.
Erre az alábbi módokon van lehetőséged:
- a tömörített állomány felmásolásával
- FTP-klienssel – például FileZilla (Windows, Linux, macOS) vagy Cyberduck (Windows, macOS)
- by using software already provided by your hosting service, such as the cPanel File Manager.
Ha a szoftverben van „feltöltött állományok neveinek kisbetűsre változtatása” opció, kapcsold ki.
Ha installáltad az Apache-t, a telepítési útvonalat a httpd.conf állomány tárolja (ez a [$docroot DocumentRoot] könyvtárban van; valószínűleg $1 vagy {{$2|apache-könyvtár}}).
By default, this is /var/www/ or <apache-folder>/htdocs.
The exact location of the Apache server settings and directories file httpd.conf depends on your operating system.
Debian és Ubuntu alatt az Apache szerver beállításai és könyvtárai a /etc/apache2/apache2.conf fájlban vannak.
In Red Hat and Fedora, the file is /etc/httpd/conf/httpd.conf.
Rename the uploaded folder to your desired name, as this will determine how it appears in the URL.
For example, if you rename the folder to wiki, the URL will reflect this as example.com/wiki.
If your web server is running as http://localhost for example, renaming the directory to /w/ would mean you would access your wiki at http://localhost/w/index.php.
/wiki/ yet if you want to set up Short URLs after running the initial configuration script.
Az adatbázis beállítása
The MediaWiki initial configuration script requires a database name and a database username to store the wiki’s content.
If you already have a database server and know the password for the root (administrator) user, you can skip directly to the Run the installation script section.
If you do not know the root user’s password, for instance if you are using a hosted server, you will need to create a new database before proceeding to the MediaWiki installation script.
MariaDB/MySQL are the recommended databases. While PostgreSQL and SQLite are supported, they offer limited compatibility and should only be used only if necessary. If you're unsure which database to choose, use MariaDB.
Once the database setup is complete, proceed to the Run the installation script below.
SQLite
No additional setup is required for SQLite if the pdo-sqlite module for PHP is installed on the system.
On the SQLite installation page, select a database name (any name is acceptable) and an SQLite database directory. The installer will attempt to use a directory outside the document root and create it if necessary. If this directory is web-readable or insecure, it should be manually changed to prevent unauthorized access.
MariaDB/MySQL
- A control panel provided by your hosting service, such as phpMyAdmin.
- SSH access to your host, where you can enter the commands below into a MySQL prompt. Refer to your hosting provider’s documentation. Alternatively, you can request that your hosting provider create the database and user for you.
The following commands will create a database named my_wiki, a user named wikiuser, and assign permissions for the user on that database.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Ha az adatbázis nem a webszerverrel azonos domainen fut, az alábbiak szerint meg kell adnod a pontos helyet (az alábbi esetben mediawiki.example.com):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Figyelem: | UNIX-on és Linuxon a MySQL- és MariaDB-naplóbejegyzések egy fájlban tárolódnak, amely tartalmazza az adatbázishoz használt jelszót is. Ha ez zavar, a parancsok futása után a MySQL dokumentációját követve töröld és tiltsd le a .mysql_history fájlt. |
PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or supply the name of a PostgreSQL user with "superuser" privileges to the configuration form.
Often, this is the database user named postgres.
The following commands on a Linux command-line, as the postgres user, create a database user named wikiuser, and a database named my_wiki owned by the user named wikiuser.
createuser -S -D -R -P -E wikiuser (majd írd be a jelszót) createdb -O wikiuser my_wiki
or as superuser (default postgres) execute the following commands at the database prompt:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Beware of the list of known issues when running MediaWiki with PostgreSQL.
A telepítőszkript futtatása
Következő lépéskét nyisd meg a MediaWiki-telepítésed index.php lapját egy böngészőben: kövesd a Kézikönyv:Konfigurációs szkript utasításait.
További beállítások
- Kézikönyv:Rendszeradminisztráció - Additional configuration
- Kézikönyv:Adminisztrátorok - Wiki administration
Maradj naprakész!
Miután kész vagy a telepítéssel, kövesd a legújabb kiadásokat, és ügyelj adatbázisod biztonságára!
Appendices
Alternatives to manual installation
Manual installation is often the preferred method because it gives the user more control and insight into how their wiki is installed, making troubleshooting and maintenance easier. Automated processes, packages, bundles, and services all come with their own idiosyncrasies.
Instead of manually installing MediaWiki, alternative options might be easier:
- pre-integrated software appliances
- hosting services with 1-click installation, or wiki farms
- software bundles
- A root felhasználónak megjegyezhető jelszót válassz.
See also the comparison of distribution options.
System-specific instructions
The pages listed on Kézikönyv:Rendszerspecifikus útmutatók give more detailed installation instructions aimed at specific systems.
However, by and large these per-system docs are less maintained and might not always be up to date. First consult A MediaWiki telepítése (this page) before looking at per-system installation documentation.
Running multiple wikis
Importing an existing wiki database