# 시스템 연결하기

> **이 장에서 배우는 것**
> 시스템이 무엇인지, 등록 두 단계, 토큰 다루는 법, 그리고 무료와 유료의 경계.

## 시스템 = 등록된 컴퓨터 한 대

Connect는 클라우드에 있고, 실제 작업이 내 컴퓨터의 파일에서 일어나야 할 때가
있습니다. **시스템**은 그 사이를 잇는 등록 단위입니다.

> **시스템 하나가 컴퓨터 한 대입니다.**

```mermaid
graph TD
  U["팀원 · 브라우저"] --> C["Connect<br/>클라우드"]
  C --> S["시스템<br/>등록된 컴퓨터 한 대"]
  S --> H["HyperTeams<br/>그 컴퓨터에서 실행 중"]
  H --> F["실제 프로젝트 폴더"]
```

[HyperTeams 트랙](/guide/ht-what-is-it)이 그 컴퓨터 쪽 이야기라면, 이 장은
**Connect 쪽에서 그 컴퓨터를 등록하는** 이야기입니다.

## 등록하기

워크스페이스 메뉴의 **내 시스템**으로 들어가면 두 단계가 안내됩니다.

![시스템 등록 화면](/guide-assets/cn-systems-list.png)

### 1단계 — 그 컴퓨터에 HyperTeams 설치

화면의 명령을 **연결할 컴퓨터에서** 실행합니다.

```bash
curl -fsSL https://hyperteams.net/install.sh | bash
```

Windows PowerShell 탭도 따로 있습니다. 자세한 것은
[설치하기](/guide/ht-install)에 있습니다.

### 2단계 — 시스템 등록하고 토큰 붙여넣기

> **이 단계는 워크스페이스 owner만 할 수 있습니다.** admin으로 들어가면 시스템
> 목록은 보이지만 **시스템 등록** 버튼이 없습니다. [역할표](/guide/cn-members)를
> 보세요.

**시스템 등록**을 누르면 이 워크스페이스에 시스템 행이 생기고 **토큰**이
발급됩니다. 그 토큰을 컴퓨터 쪽 하이퍼팀즈(HyperTeams) 설정에 붙여넣으면 연결됩니다.

## 토큰은 비밀번호와 같습니다

> **`tt_`로 시작하는 이 토큰 하나가 그 컴퓨터에 대한 접근 권한입니다.**

```
✗ 채팅방에 붙여넣기
✗ 이슈나 문서에 남기기
✗ 스크린샷에 포함시키기
✓ 그 컴퓨터의 설정 화면에만
```

**노출됐다면** 시스템을 지우고 다시 등록하는 게 가장 빠릅니다. 새 토큰이
발급되고 옛 토큰은 무효가 됩니다.

![시스템 목록](/guide-assets/cn-systems-list.png)

등록된 컴퓨터와 **자리(슬롯) 현황**이 함께 보입니다. `0 / 1대`는 쓸 수 있는 자리
대비 사용 중인 수이고, 그 옆이 서브도메인 현황입니다.

## 등록하면 생기는 화면

| 화면 | 무엇을 보나 |
|---|---|
| **시스템 목록** | 등록된 컴퓨터와 온라인 여부 |
| **작업** | 그 컴퓨터에 내린 업무와 진행 상황 |
| **사용량** | 컴퓨터별 사용량 |
| **태그** | 여러 대를 묶어 관리 |
| **도메인 · 슬롯** | 외부 주소 연결 (유료 부가 기능) |

## 무료와 유료의 경계

여기가 자주 헷갈립니다.

| | 상태 |
|---|---|
| **시스템 등록** | **무료** |
| 등록한 컴퓨터에 업무 맡기기 | 무료 |
| 진행 상황·사용량 보기 | 무료 |
| **Cloudflare 터널** | **유료 부가 기능** |

터널은 **그 시스템을 바깥 인터넷 주소로 노출하는 것**입니다. 결제하지 않아도 위의
기본 기능은 그대로 동작합니다.

> **폐쇄망(onprem) 설치본에서는 터널이 아예 꺼져 있습니다.** 외부로 나가는 통로를
> 만드는 것이 폐쇄망의 전제를 깨기 때문입니다.

## 범위에 주의하세요

[작업 폴더가 곧 활동 범위](/guide/ht-working-directory)라고 했습니다. 시스템을
워크스페이스에 등록하면 **그 범위가 팀에 열립니다.**

```
□ 그 컴퓨터의 작업 폴더가 좁게 잡혀 있나
□ 개인 파일이 있는 폴더가 등록돼 있지 않나
□ 이 워크스페이스의 멤버가 그 범위를 봐도 되나
```

**세 번째를 꼭 확인하세요.** 시스템을 등록하는 순간 그 워크스페이스 멤버가 그
컴퓨터에 작업을 시킬 수 있습니다.

## 여러 대 관리

시스템이 여러 대가 되면 **태그**로 묶습니다.

```
빌드서버-1  [빌드]
빌드서버-2  [빌드]
개발PC-김   [개발]
```

태그로 묶으면 "빌드 태그의 시스템 중 하나"에 일을 맡기는 식이 가능합니다.

---

## 확인

**1. 시스템 토큰을 어떻게 다뤄야 합니까?**

<details>
<summary>답</summary>

**비밀번호처럼** 다룹니다. `tt_` 토큰 하나가 그 컴퓨터에 대한 접근 권한이므로
채팅방·이슈·스크린샷에 남기면 안 됩니다. 노출됐다면 시스템을 지우고 다시 등록하는
게 가장 빠릅니다.
</details>

**2. 시스템 등록과 터널 중 무엇이 유료입니까?**

<details>
<summary>답</summary>

**터널이 유료 부가 기능**입니다. 시스템 등록과 업무 맡기기, 사용량 보기는
무료입니다. 폐쇄망 설치본에서는 터널이 아예 꺼져 있습니다.
</details>

**3. 시스템을 등록하기 전에 반드시 확인할 것은?**

<details>
<summary>답</summary>

**그 컴퓨터의 작업 폴더 범위**입니다. 등록하는 순간 워크스페이스 멤버가 그 범위에
작업을 시킬 수 있으므로, 개인 파일이 포함된 폴더가 등록돼 있지 않은지 봐야
합니다.
</details>

---

등록한 뒤의 화면들을 봅니다 → [시스템 관리 — 자리와 주소](/guide/cn-systems-manage)