처음 켜기

TASTEGEO 는 WMS · WFS · WMTS · WCS 와 GeoServer 꼴의 REST API 를 내는 공간정보 서버입니다. 서버(tastegeo-server)와 브라우저로 여는 관리 화면(TASTEGEO Admin) 두 가지가 함께 설치됩니다. 관리 화면은 이 PC 의 TASTEGEO 뿐 아니라 다른 TASTEGEO · GeoServer 서버도 연결해 관리할 수 있습니다. 이 설명서는 0.1.9 판을 기준으로 합니다.

받기

설치 파일은 다운로드에 있습니다.

Windows 파일은 GXSOFT(지엑스소프트) 코드 서명이, Linux 파일은 같은 이름의 .sig 서명이 붙어 있고, 모든 파일의 SHA-256 값이 SHA256SUMS.txt 에 있습니다.

설치 — Windows

필요한 것:

• Windows 10 · 11 또는 Windows Server 2019 이상(x64)
• Node.js 24 — 관리 화면을 돌립니다. 설치 파일에 들어 있지 않으므로 nodejs.org 에서 먼저 설치하세요. 없으면 관리 화면 서비스 등록이 실패합니다.

.msi 또는 -setup.exe 를 실행하면 Windows 서비스 두 개가 등록되고 자동으로 시작됩니다.

두 서비스는 LocalService 계정으로 돌고, 멈추면 1분 뒤 다시 시작합니다(하루에 세 번까지). 작업 관리자 · 서비스 목록에는 TASTEGEO 아이콘과 판 정보로 보입니다.

.zip 을 받았다면 오래 둘 폴더(예: C:\Program Files\tastedev\geo)에 풀고, 관리자 권한 PowerShell 에서 그 폴더로 가서 등록합니다.

.\register-packaged-services.ps1 -Action Install

설치 — Linux

DEB(Ubuntu · Debian)

sudo apt install ./tastedev-geo-<판>-linux-x86_64.deb

RPM

sudo dnf install ./tastedev-geo-<판>-linux-x86_64.rpm

설치가 끝나면 systemd 서비스 두 개가 켜집니다.

데스크톱 메뉴의 TASTEGEO 항목은 관리 화면을 엽니다.

tar.gz — node 명령으로 Node.js 24 가 잡혀 있어야 합니다. 풀고 나서:

sudo ./install-tastegeo.sh

AppImage 는 서비스를 등록하지 않는 휴대용 꼴입니다. 서비스로 돌리려면 DEB · RPM · tar.gz 를 쓰세요.

처음 로그인

브라우저에서 http://127.0.0.1:6740 을 열고 계정 admin 으로 로그인합니다. 첫 비밀번호는 설치할 때 만들어져 관리자만 읽을 수 있는 파일에 있습니다.

# Windows(관리자 PowerShell)
Get-Content "$env:ProgramData\TASTEGEO\setup\initial-admin-password"

# Linux
sudo cat /var/lib/tastegeo/setup/initial-admin-password

로그인한 뒤 시스템 › 관리자 계정(오른쪽 위의 이름을 눌러도 됩니다)에서 비밀번호를 바꾸세요 (인증과 보안).

관리 화면 둘러보기

위쪽 줄에는 화면 찾기(Ctrl + K, 맥은 ⌘ + K), 공지, 밝은 · 어두운 테마 단추, 지금 쓰는 연결 고르기, 로그인한 이름, 로그아웃이 있습니다. 로그인 화면에도 테마 단추가 있습니다.

왼쪽 판은 연결 트리입니다.

서버 (연결 N개)                    🔍 +
├─ 이 PC 의 TASTEGEO   127.0.0.1:8081   ●
│  ├─ 대시보드 · 지도 미리보기
│  ├─ 워크스페이스 › <워크스페이스> › 데이터스토어 · 커버리지스토어 · 레이어 · 스타일 · 레이어 그룹
│  ├─ 네임스페이스
│  ├─ 서비스 › WMS · WFS · WMTS · WCS
│  └─ 시스템 › 시스템 상태 · 전역 설정 · 로깅 · 보안 · 운영 작업
└─ (더한 다른 서버들)

• 노드를 누르면 그 연결로 바꾸고 해당 화면을 엽니다. 지금 보는 화면의 노드가 칠해집니다.
• 폴더는 펼칠 때 그 서버에 물어 내용을 받습니다. 연결 이름 옆의 점은 연결 상태(초록 연결됨 · 빨강 연결 안 됨)이고, 연결되지 않은 서버의 노드는 흐리게 막힙니다.
• 노드를 오른쪽 단추로 누르면(키보드는 메뉴 키 · Shift + F10) 열기 · 새 탭에서 열기 · 새로 만들기 · 수정 · 삭제 · 다시 받기 · 이름 복사 같은 메뉴가 나옵니다.
• 🔍 는 한 번이라도 펼친 노드를 이름으로 찾고, + 는 연결을 더합니다.

연결 관리

서버 (연결 N개) 를 누르면 연결 관리 화면이 열립니다. DB 관리 도구의 접속 관리자처럼 TASTEGEO · GeoServer 서버를 등록해 두고 골라 씁니다.

• 연결 더하기 — 이름, 종류(TASTEGEO · GeoServer), 주소(GeoServer 는 보통 http://<호스트>:8080/geoserver), 인증(없음 · Basic 계정 · Bearer 토큰)을 넣고 연결 시험으로 확인한 뒤 저장합니다. GeoServer REST 는 보통 Basic (GeoServer 관리자 계정)을 씁니다.
• 쓰기 · 연결 시험 · 수정 · 지우기 — 줄마다 있습니다. 고른 연결은 이 브라우저에만 적용되고, 카탈로그 · 서비스 · 지도 · 시스템 화면이 모두 그 연결의 서버를 봅니다.
• 복사 · 붙여넣기 — 트리에서 연결을 오른쪽 단추로 눌러 복사(Ctrl + C), 그다음 붙여넣기(Ctrl + V)하면 같은 설정의 「<이름> 사본」이 생깁니다. 사본을 수정해 다른 계정으로 같은 서버에 붙을 때 씁니다.
• 비밀번호 · 토큰은 관리 화면 서버에만 암호화해 저장하고 브라우저로 보내지 않습니다.
• 첫 줄의 이 PC 의 TASTEGEO 는 설치가 만든 기본 연결로, admin.env 의 값입니다. 0.1.9 에서는 화면에서 수정 · 삭제할 수 없습니다(바꾸려면 admin.env 를 고치거나, 복사해 사본을 수정해 쓰세요).

설정과 데이터가 있는 곳

설치는 아래 파일이 없을 때만 만들고, 다시 설치하거나 판을 올려도 그대로 둡니다.

native.json

서버 설정은 JSON 한 파일입니다(schema_version: 1, 모르는 항목이 있으면 서버가 시작하지 않습니다).

설정을 바꾼 뒤에는 서버 서비스를 다시 시작합니다.

시작 · 멈춤

# Windows
Restart-Service tastegeo_server_0.1.9
Restart-Service tastegeo_admin_0.1.9

# Linux
sudo systemctl restart tastegeo tastegeo-admin
sudo systemctl status tastegeo tastegeo-admin

밖에서 쓰기

두 서비스는 이 컴퓨터(127.0.0.1)에서만 듣습니다. 다른 컴퓨터에서 쓰려면 nginx · Caddy 같은 역방향 프록시를 앞에 두고 HTTPS 로 내보내세요. 서버에는 TLS 가 들어 있지 않습니다.

지우기

• Windows — 설정의 앱 목록이나 설치 파일로 지웁니다(ZIP 설치는 .\register-packaged-services.ps1 -Action Uninstall). 서비스와 프로그램 파일은 지워지고 %ProgramData%\TASTEGEO 는 남습니다.
• Linux — DEB 는 sudo apt remove <패키지 이름>, RPM 은 sudo dnf remove <패키지 이름> 으로 지웁니다(이름은 dpkg -l | grep -i geo · rpm -qa | grep -i geo 로 확인). tar.gz 는 sudo ./uninstall-tastegeo.sh. 어느 쪽이든 /etc/tastegeo, /srv/tastegeo, /var/lib/tastegeo 는 남습니다.

남은 폴더까지 지우면 설정 · 토큰 · 카탈로그 상태 · 연결 목록이 모두 사라집니다.