Office 설정하기
Office 관리자 페이지에서 실행 중인 Office의 라이선스, 문서 저장소 연결, 서비스 설정과 상태를 관리할 수 있습니다. Office 준비하기에 따라 컨테이너를 실행한 뒤 관리자 페이지에 접속합니다.
관리자 페이지 접속하기
앞서 안내한 명령으로 로컬에서 Office를 실행했다면 다음 주소를 엽니다.
Office에 접속하는 포트 번호를 변경했다면 URL의 8080도 해당 포트 번호로 바꿉니다.
http://localhost:8080/cloud-office/account
기본 아이디 cloud와 비밀번호 weboffice로 로그인합니다. 관리자 계정을 변경했다면 변경한 아이디와 비밀번호를 사용합니다.
로그인 후 왼쪽에 계정, 라이선스, 외부연동, 통계, 설정, 모니터링 메뉴가 표시되는지 확인합니다.
관리자 메뉴 살펴보기
| 메뉴 | 주요 기능 |
|---|---|
| 계정 | 관리자 페이지의 표시 언어와 로그인 아이디·비밀번호를 변경합니다. |
| 라이선스 | 적용된 라이선스의 종류와 유효 기간을 확인하고 라이선스 파일을 적용합니다. |
| 외부연동 | Office가 문서를 열고 저장할 스토리지 어댑터를 등록하고 관리합니다. |
| 통계 | 기간별 사용자 수, 문서 열기 횟수와 공동 편집 비율을 확인합니다. |
| 설정 | 서버 연결 정보, 편집 기능, 화면 표시, 웹 폰트와 AI 관련 옵션을 설정합니다. |
| 모니터링 | Office를 구성하는 서비스의 현재 상태와 최근 상태 변화를 확인합니다. |
라이선스와 서비스 상태 확인하기
- 라이선스에서 적용된 라이선스의 종류와 유효 기간을 확인합니다. Trial 이미지에 포함된 라이선스나 컨테이너에 마운트한 라이선스가 적용되었는지 확인합니다.
- 모니터링에서 Office 구성 요소의 상태를 확인합니다. 구성 요소별 현재 상태와 시간에 따른 변화를 함께 볼 수 있습니다.
- 모니터링에서 오류가 확인되면 설정에서 해당 구성 요소의 서버 주소와 연결 정보를 점검합니다.
스토리지 어댑터 연결하기
Office에서 문서를 읽고 저장하려면 스토리지 어댑터를 연결해야 합니다. Trial과 Free Commercial 컨테이너 이미지에는 문서 열기와 저장을 바로 테스트할 수 있도록 Host Storage 어댑터를 미리 연결해 두었습니다. 이 어댑터는 Office가 실행되는 서버의 디렉터리를 문서 저장소로 사용하며, 다음과 같이 설정되어 있습니다.
| 항목 | 설정값 |
|---|---|
| 어댑터 이름 | host-storage |
| 스토리지 표시 이름 | host-storage |
| 문서 루트 디렉터리 | /home/thinkfree/docs (컨테이너 내부 디렉터리) |
외부 연동 메뉴에서 host-storage의 업데이트 아이콘을 눌러 설정을 확인합니다.
그 외 문서 저장소를 직접 연결하려면 저장소 종류에 맞는 Host Storage, S3, WebDAV, WOPI 또는 HTTP Storage 가이드를 참고합니다. 각 가이드에서 어댑터 등록에 필요한 입력 항목과 연결 확인 방법을 안내합니다.
문서 열기와 저장 확인하기
등록한 어댑터 이름은 문서 URL 생성 시 사용할 저장소를 지정하는 데 사용합니다.
미리 연결된 어댑터를 사용할 때는 host-storage와 문서 루트를 기준으로 한 상대 경로를 지정해 문서를 엽니다.
문서를 편집하고 저장한 뒤 다시 열어 변경 내용이 유지되는지 확인합니다.
예를 들어 /home/thinkfree/docs/sample.docx를 Word 편집기로 여는 주소는 다음과 같습니다.
http://localhost:8080/cloud-office/api/host-storage/sample.docx/open?app=WORD_EDITOR&user_id=local-user&docId=hostsample001
설정 변경하기
설정 메뉴를 열고 변경하려는 항목의 탭을 선택합니다. 주요 설정은 다음과 같습니다.
| 탭 | 설정 내용 |
|---|---|
| Service | 문서 변환 서버와 공동 편집을 처리하는 문서 서버의 연결 주소 |
| MongoDB | 편집 중인 문서 데이터와 이미지 등의 리소스를 보관하는 데이터베이스 연결 정보 |
| Valkey | 세션과 캐시를 관리하는 서버의 연결 정보와 연결 방식 |
| Additional setting | 편집 기능과 서비스 동작에 관한 개별 설정 |
| UI Customization | 제품명, 로고, 파비콘과 편집기·뷰어 헤더 표시 |
| Custom Web Font | 편집기에서 사용할 웹 폰트 등록과 관리 |
| AI | AI Provider, 모델, API Key 등 AI 기능에 필요한 설정 |