file-api-server 사내 설치 · 브라우저 연동 안내

이 시스템은 “브라우저가 알 수 없는 로컬 파일/폴더의 절대경로”를 얻기 위한 두 개의 프로그램으로 구성됩니다.

JDK 설치 확인

복사java -version
:: openjdk version "17..." 등이 나오면 정상

복사setx JAVA_HOME "C:\Program Files\Java\jdk-17" /M
:: 새 명령창을 열어 반영 확인
echo %JAVA_HOME%

동봉된 배치 스크립트들이 작업 경로를 C:\file-api-server\file-api-server 로 가정합니다. 정확히 이 경로가 되도록 내려받으세요.

복사:: 1) 상위 폴더 생성 후 그 안에 clone
mkdir C:\file-api-server
cd /d C:\file-api-server
git clone https://github.com/chans97/file-api-server.git

:: 결과 경로: C:\file-api-server\file-api-server  (배치 스크립트 기본값과 일치)

방법 A(동봉 스크립트) 또는 B(직접 실행) 중 하나를 쓰면 됩니다.

방법 A — build.bat (git pull 후 빌드)

복사cd /d C:\file-api-server\file-api-server
build.bat

방법 B — Gradle 직접

복사cd /d C:\file-api-server\file-api-server
gradlew.bat clean bootJar

동봉된 start.bat을 실행하면 백그라운드(javaw, 콘솔 창 없음)로 서버가 기동됩니다. start.bat이 참조하는 JAR 이름은 빌드 산출물(file-api-server-0.0.1-SNAPSHOT.jar)과 일치합니다.

복사cd /d C:\file-api-server\file-api-server
start.bat

복사set "WORKING_DIR=C:\file-api-server\file-api-server"
set "JAR_NAME=file-api-server-0.0.1-SNAPSHOT.jar"

cd "%WORKING_DIR%\build\libs"

rem 백그라운드로 기동 (콘솔 없음)
javaw -jar %JAR_NAME%

복사cd /d C:\file-api-server\file-api-server\build\libs
java -jar file-api-server-0.0.1-SNAPSHOT.jar
:: "Started FilePathApiServerApplication ... Tomcat started on port(s): 20000" 확인 후
:: Ctrl+C 로 종료

사용자 PC에서 서버로 접속하려면 인바운드 20000을 열어야 합니다. PowerShell(관리자)에서:

복사New-NetFirewallRule -DisplayName "file-api-server 20000" `
  -Direction Inbound -Protocol TCP -LocalPort 20000 -Action Allow

서버에서(로컬) 그리고 다른 PC에서(원격) 헬스체크가 응답하면 성공입니다.

복사:: 서버 자기 자신에서
curl http://localhost:20000/hcheck

:: 다른 PC 브라우저 주소창 또는 curl 에서 (서버IP로 교체)
:: http://192.168.0.10:20000/hcheck

start.bat은 로그인 세션에서 실행되어 로그오프/재부팅 시 종료됩니다. 서버 상시 운영에는 아래 중 하나로 등록하세요.

방법 A — NSSM으로 Windows 서비스 등록 (가장 권장)

nssm.cc에서 nssm.exe를 받아 서버에 두고, 관리자 명령창에서:

복사nssm install FileApiServer "C:\Program Files\Java\jdk-17\bin\java.exe" ^
  "-jar C:\file-api-server\file-api-server\build\libs\file-api-server-0.0.1-SNAPSHOT.jar"

nssm set FileApiServer AppDirectory "C:\file-api-server\file-api-server\build\libs"
nssm set FileApiServer Start SERVICE_AUTO_START
nssm start FileApiServer

:: 상태 확인 / 중지 / 삭제
sc query FileApiServer
:: nssm stop FileApiServer
:: nssm remove FileApiServer confirm

방법 B — 작업 스케줄러

작업 스케줄러 → 작업 만들기 → 트리거 “컴퓨터 시작 시” → 동작 “프로그램 시작”에 start.bat 지정, “가장 높은 수준의 권한으로 실행” 체크.

서비스(NSSM)로 운영 시: nssm stop FileApiServer / nssm restart FileApiServer.

배치로 운영 시 동봉된 stop.bat은 jps로 프로세스를 찾아 종료합니다(경로에 “file-api-server”가 포함되어 매칭됨). 재시작은 stop.bat 후 start.bat.

웹앱(브라우저) 쪽 순서는 세 단계입니다: ①앱 호출 → ②서버 폴링 → ③경로 사용. 서버 주소는 커스텀 프로토콜 URL 안에 담겨 앱에 전달되고, 앱은 그 주소로 결과를 POST합니다. (앱 코드에는 IP가 하드코딩되어 있지 않습니다.)

커스텀 프로토콜 URL 형식

복사FilePathInterface:{protocol}/{서버IP}/{포트}/{FILE|DIR}/{id}

예) 파일 선택 :  FilePathInterface:http/192.168.0.10/20000/FILE/12345
예) 폴더 선택 :  FilePathInterface:http/192.168.0.10/20000/DIR/12345

• 서버IP/포트 = 방금 설치한 file-api-server 주소 (192.168.0.10, 20000).
• FILE = 파일 선택창, DIR = 폴더 선택창.
• id = 요청마다 겹치지 않는 정수(상관키). 서버 저장·조회 매칭에 사용.
• 주의: http 뒤는 ://가 아니라 / 입니다 (http/192.168.0.10/20000).

복사해서 쓰는 예제 (HTML/JS)

버튼을 누르면 앱을 띄우고, 서버를 1초 간격으로 폴링해 경로를 표시합니다.

복사<button id="pickFile">파일 선택</button>
<button id="pickDir">폴더 선택</button>
<p id="result"></p>

<script>
  // ── 사내 서버 주소로 교체 ──
  const SERVER_IP   = "192.168.0.10";
  const SERVER_PORT = "20000";
  const SERVER = `http://${SERVER_IP}:${SERVER_PORT}`;

  function pick(kind /* "FILE" | "DIR" */) {
    const id = Math.floor(Math.random() * 99999);       // 상관키
    document.getElementById("result").innerText = "파일 선택 중...";

    // 1) 데스크톱 앱 호출 (FilePathInterface 앱이 설치되어 있어야 함)
    window.location = `FilePathInterface:http/${SERVER_IP}/${SERVER_PORT}/${kind}/${id}`;

    // 2) 서버 폴링 (앱이 경로를 POST할 때까지 최대 60초)
    poll(id, 60);
  }

  function poll(id, triesLeft) {
    if (triesLeft <= 0) {
      document.getElementById("result").innerText = "시간 초과: 다시 시도해주세요.";
      return;
    }
    fetch(`${SERVER}/${id}`)
      .then(r => { if (!r.ok) throw new Error("not ready"); return r.json(); })
      .then(res => {
        // 응답 형식: { status:"ok", data:{ id, filename, createdAt } }
        if (res && res.data && res.data.filename) {
          document.getElementById("result").innerText = res.data.filename;   // ← 절대경로
        } else {
          setTimeout(() => poll(id, triesLeft - 1), 1000);
        }
      })
      .catch(() => setTimeout(() => poll(id, triesLeft - 1), 1000)); // 아직 없으면 재시도
  }

  document.getElementById("pickFile").onclick = () => pick("FILE");
  document.getElementById("pickDir").onclick  = () => pick("DIR");
</script>

• 데이터는 임시입니다(H2 인메모리). 서버 재시작 시 저장된 경로는 모두 사라집니다. 릴레이 용도라 정상 동작입니다.
• 최대 10건만 유지. 새 요청이 저장되면 생성시각 기준 가장 오래된 초과분만 삭제되어 항상 최신 10건이 유지됩니다.
• CORS 전역 허용. 서버가 모든 오리진을 허용(*)하도록 설정되어 있어, 사내 어떤 웹 호스트에서 호출해도 CORS로 막히지 않습니다. (쿠키/인증 미사용)
• 없는 id 조회 시 HTTP 500. 아직 앱이 경로를 올리기 전이라 그렇습니다. 위 예제처럼 폴링으로 재시도하면 됩니다.
• 포트 변경. src/main/resources/application.properties의 server.port=20000을 바꾸면 됩니다(변경 후 재빌드/재기동, 방화벽·URL도 함께 수정).