# LinClient 설치 가이드

이 가이드는 LinClient 서버의 설치 및 설정 방법을 설명합니다.

## 필수 요구사항

1. [Node.js](https://nodejs.org/) 설치 (LTS 버전 권장)
2. Apache 서버 설치 (Apache 2.4 이상)
3. Windows OS

## 자동 설치 방법

1. 관리자 권한으로 명령 프롬프트(CMD)를 실행합니다.
2. setup 폴더로 이동:
   ```
   cd C:\Apache24\htdocs\setup
   ```
3. 설치 스크립트 실행:
   ```
   setup.bat
   ```

## 수동 설치 방법

자동 설치가 실패할 경우 다음 단계를 따르세요:

1. js 폴더로 이동:
   ```
   cd C:\Apache24\htdocs\js
   ```

2. Node.js 패키지 초기화:
   ```
   npm init -y
   ```

3. 필요한 패키지 설치:
   ```
   npm install node-windows express cors
   ```

4. node-windows 링크:
   ```
   npm link node-windows
   ```

5. setup 폴더로 이동하여 서비스 설치:
   ```
   cd ..\setup
   node install-service.js
   ```

## 서비스 관리

### 서비스 상태 확인
- Windows 서비스 관리자(services.msc) 실행
- 'LinClientNodeServer' 서비스 확인

### 서비스 제어
- 시작: `net start LinClientNodeServer`
- 중지: `net stop LinClientNodeServer`
- 제거: `node uninstall-service.js`

## 문제 해결

### Node.js 관련 문제
- "Node.js가 설치되어 있지 않습니다" 오류
  - [Node.js 웹사이트](https://nodejs.org/)에서 LTS 버전 설치
- 버전 호환성 문제
  - Node.js LTS 버전 사용 권장

### 권한 관련 문제
- "액세스가 거부되었습니다" 오류
  - 관리자 권한으로 명령 프롬프트 실행
  - 파일 및 폴더 권한 확인

### 서비스 관련 문제
- 서비스가 시작되지 않는 경우
  1. 서비스 속성의 로그온 탭 확인
  2. 이벤트 뷰어에서 오류 로그 확인
  3. Node.js 경로가 시스템 환경 변수에 있는지 확인

## 설치 파일 구조

```
setup/
├── setup.bat          # 자동 설치 스크립트
├── install-service.js # 서비스 설치 스크립트
├── uninstall-service.js # 서비스 제거 스크립트
└── README.md         # 설치 가이드
```

## 지원

설치 중 문제가 발생하면 다음 단계를 따르세요:

1. 이 가이드의 문제 해결 섹션 확인
2. 이벤트 뷰어에서 오류 로그 확인
3. 관리자에게 문의

자세한 프로젝트 정보는 [메인 README](../README.md)를 참조하세요.