ISPConfig 3.2에 웹사이트 추가하는 방법

ISPConfig는 리눅스 서버용 호스팅 제어판입니다. ISPConfig는 웹사이트, 데이터베이스, FTP 및 셸 사용자, 이메일 계정 및 DNS 관리를 위한 기능을 제공합니다. 이 가이드에서는 ISPConfig에서 웹사이트, MySQL/MariaDB 데이터베이스, FTP 사용자 및 SSH 사용자를 추가하는 방법을 단계별로 보여줍니다. 이 튜토리얼에서 선택한 설정은 WordPress, Joomla, Contao, Typo3 등과 같은 전형적인 PHP 기반 CMS의 요구 사항에 해당합니다.

전제 조건

이 가이드를 따르기 위해서는 다음 전제 조건을 충족해야 합니다:

ISPConfig 호스팅 제어판이 설치된 서버입니다.
ISPConfig를 아직 설치하지 않았다면, ISPConfig 설치 가이드를 따라주세요.
ISPConfig 관리자, 리셀러 또는 클라이언트 로그인입니다. 리셀러 또는 클라이언트 로그인은 클라이언트 한도 내에서 웹사이트 추가 권한이 활성화되어 있어야 합니다.
DNS A 레코드가 이미 서버를 가리키는 웹사이트의 도메인 이름입니다.
이 튜토리얼은 Apache 및 Nginx 서버와 호환됩니다.

시연 목적으로 ‘example.com’ 도메인이 사용됩니다. 아래에서 발생하는 모든 곳에서 example.com을 자신의 도메인 이름으로 바꾸세요.

비디오

이 튜토리얼은 YouTube에서 비디오로도 제공됩니다. 클릭하여 여기를 열어주세요: https://www.youtube.com/watch?v=v8cKGK-YPLU.

ISPConfig에서 웹사이트 추가

ISPConfig에서 웹사이트 추가하기

ISPConfig 웹 UI에 로그인한 후, 상단 메뉴에서 ‘사이트’를 클릭하여 ‘사이트’ 모듈로 이동합니다.

이제 녹색 ‘새 웹사이트 추가‘ 버튼을 클릭합니다. 그 버튼이 보이지 않으면 왼쪽 메뉴에서 ‘웹사이트’라는 단어를 클릭하세요.

웹사이트 추가

웹사이트 설정 양식이 나타납니다. 이 양식을 통해 웹사이트의 세부 정보를 구성할 수 있습니다. 아래에서 필수 및 권장 설정을 설명하겠습니다.

웹사이트 설정
PHP 설정

웹사이트 설정. 모든 필드에 대한 자세한 설명을 원하시면 ISPConfig 매뉴얼을 참조하세요. 여기서는 전형적인 PHP 기반 웹사이트에 대해 설정하는 것이 권장되는 사항만 다루겠습니다. 중요한 점은 필요하지 않은 기능을 활성화하는 것은 권장되지 않습니다.

클라이언트: 이 필드는 관리자 또는 리셀러로 로그인했을 때만 나타납니다. 이 필드는 비워둘 수 있습니다. 클라이언트를 관리하려면 웹사이트를 만들기 전에 먼저 클라이언트를 생성하세요.
IPv4 주소: 여기서 를 선택하세요. 중요한 것은 서버의 모든 사이트가 동일한 IP를 가리킬 때 또는 IP 주소 중 하나만 사용해야 하며, 와 IP를 혼합하지 않아야 한다는 것입니다. 따라서 항상 를 사용하는 것이 좋습니다. 이는 이름 기반 가상 호스트를 의미합니다.
도메인: 여기서 도메인 이름을 입력하세요.
Suexec (Apache 서버 전용): suexec 체크박스는 항상 켜져 있어야 하며, 이는 PHP 스크립트가 웹사이트의 웹 사용자 아래에서 실행되도록 보장하여 현대적인 CMS에서 요구하는 대로 파일(미디어 파일 및 업데이트)을 쓸 수 있도록 합니다.
자동 서브도메인: 웹사이트가 www.example.com에서도 접근 가능해야 하고, 단지 example.com만이 아니라면 자동 서브도메인을 www로 설정하고, 그렇지 않으면 none으로 설정하세요.
SSL: 이 체크박스를 활성화하여 SSL(HTTPS)을 통해 사이트에 접근할 수 있도록 합니다. 활성화하는 것이 강력히 권장됩니다.
Let’s Encrypt SSL: SSL은 작동하기 위해 소위 SSL 인증서가 필요합니다. 자체 서명된 SSL 인증서를 가질 수도 있고(웹 브라우저에서 사이트에 접근할 때 보안 오류가 표시됨), SSL 기관에서 SSL 인증서를 구매하거나, 예를 들어 Let’s Encrypt에서 무료 SSL 인증서를 받을 수 있습니다. 이 체크박스는 바로 그것을 위해 만들어졌습니다. 이 체크박스를 활성화하면 ISPConfig가 웹사이트에 대한 무료 Let’s Encrypt SSL 인증서를 얻으려고 시도합니다. 중요한 점: 웹사이트의 도메인 이름이 이미 이 웹 서버의 IP 주소를 가리킬 때만 Let’s Encrypt SSL 인증서를 받을 수 있습니다. Let’s Encrypt SSL 인증서를 받는 데 문제가 있는 경우(웹사이트를 생성한 후 약 1분 후에 Let’s Encrypt 체크박스가 해제됨), 문제를 디버깅하기 위한 체크리스트를 보려면 Let’s Encrypt 오류 FAQ를 참조하세요.
PHP: 권장되는 PHP 모드는 PHP-FPM입니다. Nginx 웹 서버를 사용하는 경우 이 필드는 나타나지 않습니다. Nginx ISPConfig 서버는 항상 PHP-FPM을 사용합니다.
PHP 버전: 이 필드는 여러 PHP 버전이 설치된 경우에만 나타납니다. 이 웹사이트에 설치할 CMS 또는 웹 애플리케이션에서 지원하는 가장 높은 버전을 항상 사용하는 것이 좋습니다. 올바른 버전을 선택하기 위해 CMS의 시스템 요구 사항을 확인하세요.
활성화: 웹사이트를 활성화합니다.

‘저장’ 버튼을 클릭하여 웹사이트를 생성하세요. 새로 추가된 웹사이트가 웹사이트 목록에 나타납니다.

ISPConfig의 웹사이트 목록

사이트 생성에는 최대 1분이 걸릴 수 있습니다. 빨간 점이 상단 메뉴에서 사라지면 완료된 것입니다. 점의 숫자는 보류 중인 구성 변경의 수입니다.

이제 완전히 기능하는 웹사이트가 있지만 대부분의 CMS 시스템은 콘텐츠를 저장하기 위해 MySQL 또는 MariaDB 데이터베이스도 필요합니다. 다음 단계에서는 이러한 데이터베이스와 데이터베이스 사용자를 생성할 것입니다.

ISPConfig에서 MySQL 데이터베이스 및 데이터베이스 사용자 추가하기

이 단계에서는 웹사이트의 CMS 시스템에서 사용할 새로운 MySQL 사용자와 데이터베이스를 추가할 것입니다. 첫 번째 단계는 MySQL 사용자를 추가하는 것입니다.

왼쪽 메뉴에서 ‘데이터베이스 사용자‘를 클릭하세요:

데이터베이스 사용자

그런 다음 페이지 중간에 나타나는 녹색 ‘새 사용자 추가‘ 버튼을 클릭하세요.

새 데이터베이스 사용자 추가

데이터베이스 사용자 세부 정보 양식이 나타납니다.

MySQL 사용자 세부 정보

데이터베이스 사용자 입력 필드는 아래에서 자세히 설명됩니다:

클라이언트: 여기서 클라이언트를 선택하는 것은 선택 사항입니다. 그러나 사이트를 생성할 때 웹사이트를 클라이언트에 할당하기로 선택했다면, 여기서 동일한 클라이언트를 선택하는 것이 중요합니다(또는 이 예제의 경우 - 클라이언트 없음).
데이터베이스 사용자: 새 데이터베이스 사용자가 가질 이름을 여기 입력하세요. 접두사가 이름 앞에 붙여지므로 이 예제에서는 결과 데이터베이스 사용자 이름이 c0mywebsite가 됩니다. 나중에 데이터베이스 사용자 목록에서도 확인할 수 있습니다. 접두사에 대한 내용은 가이드 끝부분의 장을 참조하세요.
데이터베이스 비밀번호 및 비밀번호 반복: 새 데이터베이스 사용자에 대한 안전한 비밀번호를 두 번 입력하세요. 또는 ‘비밀번호 생성’ 버튼을 사용하여 생성할 수 있습니다. CMS를 웹사이트에 설치할 때 필요하므로 비밀번호를 기록해 두세요.

이제 저장을 눌러 데이터베이스 사용자를 생성하세요. 데이터베이스 사용자 목록으로 리디렉션됩니다. 데이터베이스에 할당할 때 MySQL에서 사용자가 생성된다는 점에 유의하세요.

새 MySQL 사용자와 함께 데이터베이스 사용자 목록

이제 목록에서 데이터베이스 사용자 이름이 ‘c0mywebsite’로 표시되며, 이는 CMS를 사이트에 설치할 때 데이터베이스 세부 정보를 입력할 때 사용해야 할 이름입니다.

이제 MySQL 데이터베이스를 생성할 것입니다. 그렇게 하려면 왼쪽 메뉴에서 ‘데이터베이스‘를 클릭하세요.

데이터베이스 메뉴

(빈) 데이터베이스 목록이 나타납니다. 거기에서 녹색 ‘새 데이터베이스 추가‘ 버튼을 클릭하세요.

ISPConfig에서 새 데이터베이스 추가

아래와 같이 데이터베이스 세부 정보를 입력하세요:

데이터베이스 구성

데이터베이스 설정에 대한 자세한 내용:

사이트: 여기서 데이터베이스가 속할 웹사이트를 선택해야 합니다. 우리의 경우 웹사이트는 ‘example.com’입니다. 올바른 웹사이트를 선택하는 것이 중요합니다. 이 설정은 예를 들어 데이터베이스가 어떤 백업에 포함될지와 데이터베이스 접근 권한이 설정되는 방식을 정의합니다.
데이터베이스 이름: 여기서 새 데이터베이스가 가질 이름을 입력하세요. 여기서는 ‘mywebsite’라는 이름을 사용하겠습니다. MySQL 사용자와 유사하게 접두사가 데이터베이스 이름 앞에 붙여지므로 결과 데이터베이스 이름은 ‘c0mywebsite’가 됩니다. 접두사에 대한 내용은 가이드 끝부분의 장을 참조하세요.
데이터베이스 사용자: 여기서 이전에 생성한 데이터베이스 사용자의 이름을 선택합니다.
활성화: 데이터베이스를 활성화하기 위해 활성화해야 합니다.

이제 저장 버튼을 누르세요. 이렇게 하면 데이터베이스와 MySQL에서 데이터베이스 사용자가 생성됩니다. 데이터베이스 목록으로 돌아가면 새 데이터베이스가 거기에 나타납니다.

ISPConfig의 웹사이트에 대한 MySQL 데이터베이스

이제 phpmyadmin을 통해 웹사이트에 접근할 수 있습니다. 목록에서 phpMyAdmin 버튼을 클릭하세요:

참고: phpMyAdmin을 찾을 수 없다는 오류가 발생하는 경우, ISPConfig 설치 후 시스템 > 인터페이스 > 기본 구성에서 phpMyAdmin의 URL이 아직 구성되지 않았습니다. URL은 일반적으로 Apache 시스템에서는 https://server1.example.com/phpmyadmin이고, Nginx 시스템에서는 https://server1.example.com:8081/phpmyadmin입니다. 여기서 server1.example.com은 호스팅 서버의 호스트 이름입니다.

웹사이트 파일 접근하기

우리는 이미 웹사이트와 MySQL 데이터베이스를 생성했지만, CMS 시스템을 설치하려면 FTP 또는 SSH를 통해 웹사이트 폴더에 접근할 수 있어야 합니다. 이 장에서는 웹사이트에 FTP(FTPS) 및 SSH(SFTP) 접근을 부여하는 방법을 보여줍니다.

ISPConfig에서 FTP 사용자 추가하기

왼쪽 메뉴에서 웹 접근 > FTP 계정을 클릭하여 FTP 사용자 목록으로 이동합니다.

ISPConfig에서 FTP로 웹사이트 접근하기

나타나는 페이지에서 녹색 ‘새 FTP 사용자 추가‘ 버튼을 클릭하세요.

FTP 사용자 목록

FTP 사용자 세부 정보 양식이 나타납니다:

ISPConfig의 FTP 사용자

어떤 필드에 어떤 내용을 입력해야 하는지에 대한 세부 사항은 다음과 같습니다:

웹사이트: 여기서 FTP 사용자가 속할 웹사이트를 선택하세요. 우리의 예제에서는 웹사이트 이름이 ‘example.com’입니다.
사용자 이름: 여기서 FTP 사용자에 대한 사용자 이름을 입력하세요. 사용자 이름 앞에 접두사가 자동으로 붙여집니다.
비밀번호 및 비밀번호 반복: 여기서 안전한 비밀번호를 두 번 입력하거나 ‘비밀번호 생성’ 버튼을 사용하세요.
활성화: 이 체크박스는 FTP 접근을 활성화하기 위해 체크되어야 합니다.

이제 ‘저장‘을 눌러 FTP 사용자를 생성하세요. FTP 사용자 목록으로 리디렉션됩니다. 여기에는 접두사가 포함된 FTP 사용자 이름도 표시됩니다.

FTP 사용자

우리는 ISPConfig에서 FTP 사용자를 성공적으로 생성했습니다. 이를 통해 우리는 모든 FTP 클라이언트를 통해 웹사이트에 접근할 수 있습니다. 지원되는 프로토콜은 FTP 및 FTPS(FTP over TLS)입니다. SFTP(이름은 비슷하지만)는 SSH 파일 접근이며 FTP가 아니므로 해당 프로토콜을 사용하려면 SSH 사용자가 필요합니다(다음 장에서 생성합니다).

그렇다면 이제 FTP 클라이언트에서 어떤 세부 정보를 사용해야 할까요?

서버: FTP 서버 이름은 서버의 호스트 이름입니다. 이는 일반적으로 FTP 서버의 SSL 인증서가 발급되는 이름입니다. 내 서버의 호스트 이름은 ‘server1.example.com’이므로, FTP 클라이언트가 FTP 서버의 이름을 요청할 때 ‘server1.example.com’을 입력합니다.
FTP 사용자 이름: FTP 사용자 이름은 접두사가 포함된 전체 사용자 이름입니다. 이 예제의 경우 접두사는 ‘default’이고 사용자 이름은 ‘mywebsite’이므로, FTP 클라이언트에 입력할 결과 FTP 사용자 이름은 ‘defaultmywebsite’입니다. 참고로 접두사가 마음에 들지 않는 경우, 가이드 끝부분의 장을 참조하여 대부분의 시스템에서 접두사가 필요한 이유와 이를 비활성화하거나 변경하는 방법을 확인하세요(서버의 관리자일 경우).
FTP 비밀번호: 위의 FTP 사용자 양식에서 설정한 비밀번호입니다.

그렇다면 이제 파일을 어디에 업로드해야 할까요? 웹사이트 루트는 ‘ web ‘이라는 이름의 폴더로, 여기에서 CMS 파일을 업로드합니다. ‘web’ 폴더는 브라우저의 주소 표시줄에 사이트의 도메인 이름을 입력할 때 웹 브라우저로 접근하는 폴더입니다. 웹 브라우저로 접근할 수 없는 파일을 웹사이트에 저장하려면 ‘ private ‘이라는 이름의 폴더에 업로드할 수 있습니다.

ISPConfig에서 SSH / SFTP / 셸 사용자 추가하기

SSH 및 SFTP를 통해 웹사이트에 접근할 수 있는 셸 사용자를 추가하는 것은 FTP 사용자를 추가하는 것과 매우 유사합니다. 첫 번째 단계는 왼쪽 메뉴에서 명령줄 > 셸 사용자를 클릭하는 것입니다.

ISPConfig 메뉴의 셸 사용자

중간 섹션에 셸 사용자 페이지가 나타납니다. 거기에서 녹색 ‘새 셸 사용자 추가‘ 버튼을 클릭하세요.

ISPConfig에서 새 SSH / SFTP 사용자 추가

셸 사용자 세부 정보 양식이 나타납니다.

ISPConfig SSH 사용자

다음 필드를 입력해야 합니다.

사이트: 여기서 이 SSH 사용자가 접근할 웹사이트를 선택합니다. 우리의 예제에서는 웹사이트 이름이 example.com입니다.
사용자 이름: 원하는 사용자 이름을 여기 입력하세요. FTP 사용자와 마찬가지로 접두사가 적용됩니다.
비밀번호 및 비밀번호 반복: 새 SSH 사용자에 대한 안전한 비밀번호를 여기 입력하세요.
Chroot 셸: 여기서 jailkit을 선택하면 SSH 사용자가 웹사이트 루트에 갇히게 됩니다. 이는 권장되며 추가적인 보안 계층을 추가하지만, 사용자는 자신의 감옥에 설치된 프로그램과 파일만 접근할 수 있습니다. 이 필드는 관리자에게만 표시되며, 클라이언트와 리셀러의 경우 이 필드의 값은 클라이언트 한도에 의해 미리 정의될 수 있습니다.
SSH-RSA 공개 키: 비밀번호 대신 또는 추가로 SSH 접근을 위해 공개 키 인증을 사용하려면 여기에 공개 키를 입력할 수 있습니다.

이제 저장을 클릭하면 SSH 사용자가 생성됩니다. 이 작업은 최대 1분이 걸릴 수 있으며, 변경 사항이 디스크에 기록될 때까지 상단 내비게이션 바에서 빨간 깜박이는 표시기를 볼 수 있습니다.

셸 SSH SFTP 사용자

이 SSH 사용자를 통해 SFTP(SSH 파일 전송) 클라이언트를 사용하거나 ssh 명령 또는 Putty와 같은 SSH 클라이언트를 사용하여 터미널 접근을 할 수 있습니다. SSH 또는 SFTP 클라이언트에서 사용할 세부 사항은 다음과 같습니다:

서버: 여기서 서버의 호스트 이름을 사용하세요. 내 경우 호스트 이름은 server1.example.com입니다.
SSH 사용자 이름: SSH 사용자 이름은 접두사가 포함된 전체 사용자 이름입니다. 이 예제의 경우 접두사는 ‘default’이고 사용자 이름은 ‘mywebsite’이므로, 결과 사용자 이름은 ‘defaultmywebsite’입니다.
SSH 비밀번호: 위에서 입력한 비밀번호이거나, SSH 키를 사용한 경우 해당 키를 사용할 수 있습니다.

SSH 사용자로 웹사이트 폴더로 이동하는 방법은?

리눅스 셸에서 다른 폴더로 변경하는 명령은 ‘cd’입니다. SSH 사용자로 웹사이트에 로그인하면 SSH 사용자의 홈 폴더(사용을 시작할 때는 비어 있음)에 도착합니다. 웹 폴더(웹사이트 파일이 포함된 폴더)로 가려면 다음과 같이 cd 명령을 사용합니다:

cd ../../web/

위 명령은 감옥에 갇힌 SSH 사용자와 비감옥 SSH 사용자 모두에게 작동합니다. 감옥에 갇힌 사용자에게는 다음과 같은 대안을 사용할 수 있습니다:

cd /web

감옥에 갇힌 SSH 사용자의 루트 폴더는 웹사이트 루트이며, http 루트 또는 httpdocs라고도 불리는 웹사이트 파일이 포함된 폴더는 ‘web’이라는 이름의 폴더입니다.

ISPConfig의 사용자 이름 접두사

사용자 이름 접두사는 왜 사용되나요? 리눅스의 대부분의 서비스는 인증을 위해 사용자 이름과 비밀번호를 사용하며, 사용자 이름은 서버에서 고유해야 합니다. ISPConfig는 여러 클라이언트가 사용할 수 있는 호스팅 제어판으로, 각 클라이언트는 자신의 사용자만 볼 수 있습니다. 이제 다음과 같은 문제가 발생할 수 있습니다: 클라이언트 A가 ‘tom’이라는 이름의 FTP/SSH/데이터베이스 사용자를 생성합니다. 클라이언트 B가 ISPConfig에 로그인하여 ‘tom’이라는 이름의 새 FTP 사용자를 생성하려고 합니다. 그는 ‘tom’이라는 이름의 사용자가 이미 존재한다는 오류를 받게 되지만, 이 사용자는 클라이언트 A에 속하므로 볼 수 없습니다. 그는 아마도 소프트웨어에 오류가 있다고 생각하고 ISP의 지원팀에 연락할 것입니다. 여기서 사용자 이름 접두사가 등장합니다. ISPConfig는 기본적으로 이를 구성하며, 예를 들어 데이터베이스 또는 데이터베이스 사용자 앞에 ‘c + 클라이언트 ID’가 추가되거나, 클라이언트가 없는 경우 SSH 또는 FTP 사용자 앞에 클라이언트의 사용자 이름(기본적으로 ‘default’라는 단어)이 추가됩니다. 이를 통해 각 클라이언트는 ‘tom’이라는 사용자를 가질 수 있지만, 접두사가 사용자 이름의 일부가 되어 고유하게 만듭니다. 그러나 모든 ISPConfig 서버가 호스팅 시스템으로 사용되는 것은 아니며, 예를 들어 ISPConfig를 홈 서버나 내부 회사 서버의 패널로 사용할 수 있으므로 사용자 이름 접두사가 필요하지 않고 ISPConfig가 이를 추가하는 것이 불편할 수 있습니다. 그러나 이는 ISPConfig에서 사용자 이름 접두사를 자유롭게 구성할 수 있으므로 쉽게 해결할 수 있습니다. 이를 제거하려면 시스템 > 인터페이스 > 기본 구성으로 이동하세요(관리자 사용자로 로그인한 상태에서):

사용자 이름 접두사

모든 접두사 필드를 비우고 저장 버튼을 누르세요:

사용자 이름 접두사 비활성화

이제 사용자 이름 및 데이터베이스 이름 접두사가 비활성화되었습니다. 기존 사용자에 대한 접두사는 제거되지 않으므로 기존 사용자 이름은 변경되지 않으며 이러한 설정을 변경해도 로그인에 문제가 발생하지 않습니다.

링크

문제를 해결하기 위해 추가로 읽을 수 있는 몇 가지 링크입니다.

ISPConfig 홈페이지
ISPConfig의 옵션에 대한 자세한 설명
모든 지원 운영 체제에 대한 ISPConfig 설치 지침
ISPConfig 커뮤니티에서 문제가 발생할 경우 도움 받기
이메일 또는 원격 로그인으로 비즈니스 지원 받기