웹 호스팅에 Studio 설치하기
웹사이트가 PHP를 지원하는 일반 웹 호스팅에서 실행된다면 Studio를 snaps라는 폴더에 바로 설치할 수 있습니다. ZIP 파일 하나를 업로드하고 페이지 하나를 열면 다음과 같은 주소에서 Studio를 사용할 수 있습니다: yourcompany.com/snaps
- 적합 대상
- PHP를 지원하는 일반 웹 호스팅에서 웹사이트를 운영하는 모든 분: cPanel, Hostinger의 hPanel, Plesk, DirectAdmin 또는 FTP로 접속하는 호스트.
- 필요한 것
- Studio가 있는 계정으로 로그인한 Windows용 또는 Mac용 Maxisnap, 그리고 호스팅 제어판 또는 FTP 로그인 정보.
- 호스팅
- Apache 또는 LiteSpeed에서 PHP 8.0 이상, .htaccess 규칙 사용 가능. 거의 모든 공유 호스팅 요금제가 이 조건을 갖추고 있습니다.
- 소요 시간
- 약 10분.
- 결과
- 내 웹사이트의 snaps 폴더에 있는 Studio, 주소는 yourcompany.com/snaps 같은 형태입니다.
- 비용
- 추가 비용은 없습니다. Studio는 이미 비용을 내고 있는 호스팅을 사용합니다.
시작 방법
Maxisnap에서 Studio 다운로드를 받고, Start Here 페이지에서 업로드 파일을 만든 다음, 호스팅의 File Manager로 업로드합니다. Windows용 Maxisnap과 Mac용 Maxisnap 모두 사용할 수 있습니다.
Studio 다운로드 받기
- Windows: Maxisnap에서 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭한 다음 “대시보드 다운로드”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장하고 그 폴더를 엽니다.
- Mac: Maxisnap에서 Settings → Welcome & Help → Studio Setup Guide를 열고 “Get Started”를 클릭한 다음 “Download Dashboard”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장합니다.
ZIP 파일의 압축을 풉니다. Windows에서는 마우스 오른쪽 버튼으로 클릭하고 “모두 추출”을 선택합니다. Mac에서는 두 번 클릭합니다.
업로드 파일 만들기
- Studio 폴더의 “Maxisnap Studio - Start Here.html”을 두 번 클릭하세요. 브라우저에서 열립니다.
- 로고, 색상, 글꼴을 추가하거나 Maxisnap 기본 디자인을 그대로 쓰세요. 나중에 대시보드에서 모두 바꿀 수 있습니다.
- “Lock in my branding”을 클릭하세요. Maxisnap 기본 디자인을 유지하려면 “Download snaps.zip only”를 클릭하세요. 브라우저가 다운로드 폴더에 snaps.zip을 저장합니다.
데스크톱 Chrome 또는 Edge에서는 이 페이지가 Studio 다운로드의 snaps 폴더를 직접 업데이트할 수도 있습니다. 요청이 나오면 압축을 푼 Studio 폴더를 선택하고 변경을 허용하세요. 이 기능은 FTP로 업로드할 때만 필요합니다.
snaps.zip을 호스팅에 업로드
호스팅 업체는 제어판에 File Manager를 제공합니다. 사용 중인 제어판을 선택하면 정확한 단계를 볼 수 있습니다. 작업을 마치면 public_html 안에 snaps 폴더가 있고, 그 안에 index.php가 들어 있습니다.
cPanel
- cPanel에 로그인하고 File Manager 열기 대부분의 호스팅 업체에서는 계정 페이지의 “cPanel”을 클릭한 다음 “File Manager”를 클릭하면 됩니다.
- public_html 열기 웹사이트의 메인 폴더입니다. 일부 호스팅 업체에서는 www 또는 htdocs라고 부릅니다.
- snaps.zip 업로드 Upload를 클릭하고 snaps.zip을 선택한 다음 public_html로 돌아갑니다.
- 압축 풀기 snaps.zip을 마우스 오른쪽 버튼으로 클릭하고 Extract를 선택한 다음 public_html에 압축을 풉니다. 이제 snaps라는 폴더가 보여야 합니다.
Hostinger
- hPanel을 열고 Websites, Dashboard 순서로 이동 Studio를 설치할 웹사이트를 선택합니다.
- File Manager를 열고 public_html로 이동 왼쪽 메뉴의 Files 아래에 있습니다.
- snaps.zip 업로드 오른쪽 위의 업로드 아이콘을 사용해 snaps.zip을 선택합니다.
- 압축 풀기 snaps.zip을 마우스 오른쪽 버튼으로 클릭하고 Extract를 선택합니다. 폴더 이름은 비워 두세요. 그러면 public_html에 바로 압축이 풀립니다.
Plesk
- Plesk에서 Files 열기 도메인을 선택한 다음 Files를 선택합니다.
- httpdocs 열기 Plesk에서 웹사이트의 메인 폴더입니다.
- snaps.zip 업로드 더하기(+) 버튼을 클릭한 다음 Upload File을 선택합니다.
- 압축 풀기 snaps.zip에 체크 표시를 한 다음 Extract Files를 선택합니다.
DirectAdmin
- File Manager 열기 System Info & Files 아래에 있습니다.
- domains, 내 도메인, public_html 순서로 열기
- snaps.zip 업로드 Upload files to current directory를 사용합니다.
- 압축 풀기 snaps.zip을 클릭하고 Extract를 선택합니다.
FTP / SFTP
- FTP 프로그램 열기 FileZilla, WinSCP, Cyberduck 중 하나에 호스팅 업체가 알려 준 FTP 정보를 입력합니다.
- 업로드할 snaps 폴더 찾기 Studio 폴더 안에 있습니다. 브랜딩을 적용한 snaps.zip을 만들었다면 먼저 압축을 풀고(마우스 오른쪽 버튼으로 클릭한 다음 모두 추출) 그 안의 snaps 폴더를 사용하세요.
- snaps 폴더를 public_html에 업로드 숨겨진 .htaccess 파일도 포함하세요. FileZilla에서는 Server, Force showing hidden files 순서로 선택합니다.
- 결과 확인 이제 public_html에 snaps 폴더가 있고 그 안에 index.php가 있어야 합니다.
Studio를 한 번 열어 마무리
Studio를 처음 열면 간단한 설정이 실행됩니다. 이 설정은 호스팅을 점검하고 관리자 키를 알려 줍니다.
- 브라우저에서 Studio 주소를 여세요. 예: https://yourcompany.com/snaps/.
- 맨 위의 목록을 확인하세요: PHP 버전, 쓰기 가능한 폴더, 이미지 썸네일. 썸네일은 선택 사항이며, 없으면 Studio는 전체 크기 이미지를 표시합니다.
- 페이지가 제안하는 관리자 키를 복사하세요. 키는 비밀번호 관리자 같은 안전한 곳에 보관하세요. 이 키로 대시보드에 로그인하며, 키를 가진 사람은 누구나 내 Studio를 사용할 수 있습니다.
- “Create my dashboard”를 클릭하세요. Studio가 로그인된 상태로 대시보드를 엽니다.
Maxisnap을 연결하고 사용해 보기
- Windows용 Maxisnap: 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭하고, 4단계 “Maxisnap 연결”이 나올 때까지 “다음”을 클릭합니다. Studio 주소와 키를 붙여넣고 “연결 테스트”를 클릭한 다음 “다음”을 클릭하고, 마지막 페이지에서 “완료 및 저장”을 클릭합니다. 설정할 때 받은 관리자 키도, 대시보드의 People & access에 있는 업로드 코드도 사용할 수 있습니다.
- Mac용 Maxisnap: Settings → Welcome & Help → Studio Setup Guide를 열고 “I already have a dashboard”를 선택합니다. Studio 주소와 키를 붙여넣고 “Test Connection”, “Next”, “Finish & Save”를 차례로 클릭합니다.
무엇이든 캡처한 다음 편집기에서 “업로드”를 클릭하세요. Windows에서는 Ctrl+Alt+7을 누르면 영역을 캡처하고 바로 업로드합니다. 공유 링크는 클립보드에 복사됩니다.
다음 단계: 대시보드의 People & access에서 팀원을 추가하세요(모든 팀원이 각자의 코드와 역할을 받습니다). 로고나 색상은 Branding에서 언제든 바꿀 수 있습니다.
문제가 생겼을 때
Studio 주소를 열면 “404 Not Found”라고 표시됩니다
주소와 폴더가 아직 맞지 않습니다. File Manager에서 snaps 폴더가 public_html(일부 호스팅 업체에서는 www, htdocs 또는 httpdocs) 바로 안에 있고 그 안에 index.php가 있는지 확인하세요. public_html/snaps/snaps처럼 폴더 안에 폴더가 또 있다면 ZIP 파일의 압축이 한 단계 너무 깊게 풀린 것입니다. 안쪽 snaps 폴더를 한 단계 위로 옮기세요.
index.php가 올바른 위치에 있는데도 Studio의 설정 페이지나 공유 링크에 계속 404가 표시된다면, 호스팅이 Studio의 .htaccess 규칙을 무시하고 있는 것입니다. 호스팅 업체에 해당 폴더에서 URL 재작성(mod_rewrite)을 사용하는 .htaccess 파일을 허용해 달라고 요청하세요. nginx 서버에서는 웹 개발자가 Studio 다운로드에 포함된 Developer guide의 규칙을 추가합니다.
설정 페이지에 PHP 8.0 이상이 필요하다고 표시됩니다
사이트가 이전 PHP 버전에서 실행되고 있습니다. 대부분의 호스팅 제어판에는 웹사이트의 PHP 버전을 선택하는 설정이 있습니다. 호스팅이 제공하는 최신 버전을 선택하거나, 호스팅 업체에 대신 변경해 달라고 요청하세요. 그런 다음 설정 페이지를 새로 고치세요.
설정 페이지에 폴더에 쓸 수 없다고 표시됩니다
This folder is not writable, so setup cannot save. Set the folder to writable (chmod 755) and reload.
File Manager에서 snaps 폴더를 마우스 오른쪽 버튼으로 클릭하고 권한 설정을 열어 755로 지정하세요. 그런 다음 설정 페이지를 새로 고치세요. 권한을 변경할 수 없다면 호스팅 업체에 PHP가 이 폴더에 쓸 수 있도록 설정해 달라고 요청하세요.
설정 페이지에 양식이 만료되었다고 표시됩니다
This setup form expired. Reload this page and try again.
설정 페이지가 오랫동안 열려 있었습니다. 페이지를 새로 고치고, 새로 표시된 관리자 키를 복사한 다음 “Create my dashboard”를 클릭하세요.
설정 페이지에 대시보드가 이미 설정되었다고 표시됩니다
This dashboard has already been set up. Sign in with its existing key.
이 폴더에서 설정이 이미 실행되었으므로 Studio가 설치되어 있습니다. Studio 주소를 열고 처음 설정할 때의 관리자 키로 로그인하세요.
호스팅에 snaps 폴더가 이미 있습니다
아마 이미 설치된 Studio일 것입니다. 그 위에 업로드하지 마세요. 업데이트하려면 새 다운로드의 snaps 폴더에 있는 “How to update.txt”를 따르세요. 캡처, 팀원, 브랜딩, 설정은 그대로 유지됩니다. 두 번째 Studio를 설정하려면 다른 폴더 이름을 사용하세요.
관리자 키를 잃어버렸습니다
Studio는 이 키를 호스팅의 snaps 폴더에 있는 your-settings.php 파일에 보관합니다. File Manager의 보기 또는 편집 기능으로 이 파일을 열면 dashboard_key 뒤에 있는 값이 키입니다. 이 파일은 공유하지 말고 삭제하지도 마세요.
큰 동영상 업로드가 실패합니다
호스팅의 PHP 제한이 파일 크기보다 작습니다. 호스팅 업체에 사이트의 upload_max_filesize와 post_max_size를 늘려 달라고 요청하거나, 제어판에 PHP 설정 페이지가 있으면 직접 늘리세요. Studio 자체 한도는 직접 바꾸지 않았다면 파일당 500 MB입니다.
공유 링크가 잘못된 주소를 사용하거나 "http://"로 시작합니다
Studio는 설정 페이지를 처음 열 때의 주소를 저장합니다. 설정 페이지를 http:// 주소나 다른 주소로 열었다면 snaps 폴더의 your-settings.php를 열어 base_url을 Studio 주소로 설정하세요. 이 주소는 다음 문자로 시작해야 합니다: https://. 그런 다음 대시보드를 새로 고치세요.
업로드나 브랜딩 변경이 저장 관련 메시지와 함께 실패합니다
Studio could not save this change. Check your hosting file permissions and storage, then retry.
Studio가 자신의 폴더에 쓸 수 없습니다. snaps 안의 uploads와 data 폴더에 쓰기 권한이 있는지(보통 755) 그리고 호스팅 요금제에 남은 디스크 공간이 있는지 확인하세요.
업데이트한 뒤 변경 사항이 보이지 않습니다
호스팅 또는 CDN이 이전 버전의 페이지를 보여 주고 있을 수 있습니다. 제어판에서 호스팅 캐시와 CDN 캐시를 지운 다음 다시 로그인하세요.
Start Here 페이지에서 로고나 글꼴이 거부됩니다
Please choose a logo under 150 KB.
로고를 더 작은 PNG 또는 SVG 파일로 저장한 다음 다시 선택하세요. 사용자 지정 글꼴 파일은 각각 600 KB 미만이어야 합니다.
그래도 해결되지 않나요?
이메일로 문의해 주시면 담당자가 보통 영업일 기준 하루 안에 답장해 드립니다. 아래 정보를 함께 보내 주시면 한 번에 답변해 드릴 수 있습니다:
- 선택한 설정 방법과 현재 진행 중인 단계.
- 화면 스크린샷(오류 메시지가 있다면 전체 내용이 보이게).
- Studio를 설치할 위치: 새 Cloudflare 계정 또는 기존 Cloudflare 계정, 또는 웹 호스팅 업체 이름.
- Maxisnap 버전: Windows에서는 설정 → 정보에서, Mac에서는 Maxisnap → About Maxisnap에서 확인할 수 있습니다.
관리자 키, Cloudflare 키, 비밀번호는 보내지 말아 주세요. 도움을 드리는 데 필요하지 않습니다.