아래 글의 내용 중 casaos 설치 방법 – 우분투 초기 설정 기준 입니다.
CasaOS 설치
CasaOS는 간편한 홈 서버 운영체제로, Docker를 기반으로 다양한 애플리케이션과 개인 클라우드를 쉽게 관리할 수 있는 오픈소스 플랫폼입니다. 직관적인 UI로 초보자도 간단히 설치하고 사용할 수 있습니다.
CasaOS 설치 명령어
설치 방법은 너무 간단합니다. 아래 명령어를 입력하면 자동으로 설치됩니다.
전 우분투 설치하자마자 바로 casaos 설치 하였습니다.
curl -fsSL https://get.casaos.io | sudo bash같이 설치되는 프로그램들
다음과 같은 종속성 프로그램들이 함께 설치됩니다. 추 후 중복되는건 설치 할 필요가 없겠습니다.
많이 설치하는 samaba, cifs-utils, docker(docker compose), rclone 따로 설치 할 필요가 없다는거죠
필수 시스템 패키지들:
- wget: 파일 다운로드 도구
- curl: 데이터 전송 도구
- smartmontools: 저장장치 모니터링 도구
- parted: 디스크 파티션 도구
- ntfs-3g: NTFS 파일시스템 지원
- net-tools: 네트워크 도구 모음
- udevil: 외부 저장장치 자동 마운트 도구
- samba: 파일 공유 서비스
- cifs-utils: Windows 파일 공유 지원
- mergerfs: 여러 저장장치를 하나로 통합
- unzip: 압축 해제 도구
주요 컴포넌트들:
- Docker: 컨테이너 플랫폼 (버전 20 이상 필요)
- Rclone: 클라우드 스토리지 동기화 도구 (v1.61.1 설치)
CasaOS 설정
설치가 완료되면 아래와 같이 해당 ip로 접속하라는 안내가 나옵니다. 해당 아이피로 접속합니다.
사용자 설정 및 포트변경
설치 완료 후 3~4분 지난 후 설치한 장치의 아이피로 접속을 합니다.(기본포트 80으로 되어 있으니 그냥 아이피만 입력)
그리고 아이디와 비번을 설정 해줍니다.
접속 후 좌측 상단 설정을 클릭 후 webui 포트를 변경 해줍니다.
비공식 스토어 추가
App Store 클릭 후 아래 그림 같이 앱 더보기를 클릭 하고 아래 추가 앱스토어를 추가해줍니다.
아래 리스트별로 나와 있습니다.
https://awesome.casaos.io/content/3rd-party-app-stores/list.html
아래 두개의 스토어 정도만 추가해주셔도 됩니다.
bigbeartechworld
https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zipCasaOS-Coolstore
https://casaos-appstore.paodayag.dev/coolstore.zipCasaOS 구조
기본적으로 앱 설치 시 아래의 폴더로 docker-compose.yml 파일이 생성됩니다.
/var/lib/casaos/apps/설치앱명
해당 데이터 폴더는
/DATA/AppData/설치앱명
해당 docker를 새롭게 빌드할 경우 해당 폴더를 이용하시면 되겠습니다. (n8n 같이 빌드가 필요한 경우가 있습니다.)
설치는 여기까지만 보시면 되겠습니다. nginx 설치와 cloudflare ssl/tls 설정을 마치고 아래 nginx 설정으로 넘어가시기 바랍니다.
CasaOS nginx 설정
cloudflare에서 casa or casaos 라는 서브도메인을 작성 한 후 진행합니다.
아래 이미지처럼 레코드 추가 후 이름에 casa 집어넣고 콘텐츠에 아이피 입력하시면 됩니다.
casaos 같은 경우 아래와 같이 nginx 설정해주면 됩니다. (casa를 앞에 붙여 서브도메인으로 진행)
“domain.com” 을 자신의 도메인명으로 변경해주세요
sudo nano /etc/nginx/sites-available/casa.domain.com아래 복사 붙여넣기 후 Ctrol+X 로 저장 – “domain.com” 을 자신의 도메인명으로 변경해주세요
# casa.domain.com
server {
listen 80;
server_name casa.domain.com; #casa 서브도메인으로 등록했을때
# HTTP 요청을 HTTPS로 리디렉션
return 301 https://$host$request_uri;
}
# HTTPS 설정
server {
listen 443 ssl;
server_name casa.domain.com; #casa 서브도메인으로 등록했을때
# SSL certificates
ssl_certificate /etc/ssl/certs/domain.com.pem;
ssl_certificate_key /etc/ssl/private/domain.com.key;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
# SSL settings
ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers on;
# Security headers organizr ifremae 설정
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header Content-Security-Policy "frame-ancestors 'self' https://home.domain.com" always;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
proxy_pass http://localhost:8007/; #casaos 설정한 포트지정
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}그리고 심볼링 링크파일 생성 – “domain.com” 을 자신의 도메인명으로 변경해주세요
sudo ln -s /etc/nginx/sites-available/casa.domain.com /etc/nginx/sites-enabled/nginx 재실행
sudo systemctl restart nginx주소창에 해당주소 casa.domain.com을 입력하면 본인의 서버 설치된 casaos 페이지에 접속이 가능해집니다.
도움 되셨으면 따듯한 커피한잔 부탁드려요!
도움 되셨으면 유튜브 구독 부탁드려요!!!!
관련 글들..
Paperless-ngx 설치 방법 – Docker Compose 설치 가이드(ai 포함)
#auto Paperless-ngx는 효율적인 문서 관리 시스템으로, 디지털화된 문서를 정리하고 관리하는 데 도움을 주는 오픈 소스 애플리케이션입니다. 이 시스템은 종이 문서를 스캔하여 디지털화하고, 이를 효율적으로 분류하고 검색할 수 있도록 돕는 다양한 기능을 제공합니다. Paperless-ngx는 특히 문서 저장소와 작업 흐름을 자동화하여, 사용자가…
홈서버관리 대시보드 organizr 설치 – nginx & php8.4 기반
아래글의 내용중 홈서버관리 대시보드 organizr 설치 – nginx & php8.4 기반 가이드입니다. #auto 홈서버 관리 대시보드 역활을 하는 Organizr V2 입니다. 나스에 많은 서비스와 IP와 포트를 외울 필요 없이 organizr 을 사용하여 하나의 웹페이지에 나타낼수가 있습니다. 많은 정보를 보시려면 아래…
Cloudflare SSL/TLS 적용 – 클라우드플래어 https 설정 가이드
아래 글의 내용중 Cloudflare SSL/TLS 적용 – 클라우드플래어 https 설정 가이드입니다. #auto Cloudflare SSL의 주요 장점 두 서비스의 비교 비용 관리 편의성 보안 기능 유연성 선택 기준 Cloudflare는 종합적인 웹 보안 및 성능 최적화가 필요한 경우에 적합하며, Let’s Encrypt는 단순히…
도메인 구매와 cloudflare로 이전
아래 글의 내용중 도메인 구매와 cloudflare로 이전 글입니다. #auto 도메인 저렴한게 구매하면 커피 한잔 값이라고 생각하면 되겠습니다. (저도 모으다 보니 도메인이 5개가 되었네요) 아래는 저렴하게 구매가 가능한 사이트 입니다. namesilo에서 주로 구매하고 이번에 글 작성 목적으로 namecheap에서 진행 해 봤습니다.…
Nginx – extras 설치와 기본 설정
아래글의 내용중 Nginx – extras 설치와 기본 설정입니다. #auto 도메인 호스팅할때 필요한 nginx 설치 방법 입니다. 아래는 nginx 패키지별 모듈 차이점입니다. 패키지 기본 모듈 설명 nginx – 기본 HTTP 모듈 (예: ngx_http_core_module, ngx_http_vhost_traffic_status_module 등) 기본적인 HTTP 웹 서버 기능 제공.…
