FSL 6.0.7.23은 Apple Silicon Mac에 어떻게 설치하나요? 2026
실험실에 Mac이 없거나 Apple Silicon Mac에서 FSL을 처음 설정하는 연구자를 위한 설치 안내입니다. 공식 설치 경로부터 명령줄, FSLeyes, 대표 MRI 프로젝트의 검증까지 단계별로 살펴보고 원격 macOS 환경이 필요한 조건도 판단합니다.
목차
이번 주에는 FSL 공식 macOS 안내에 따라 getfsl.sh로 설치한 뒤, 명령줄과 FSLeyes, 실제 MRI 프로젝트를 각각 확인하세요. 설치가 끝났다는 사실만으로 연구 워크플로까지 검증된 것은 아닙니다. Apple Silicon 지원 여부와 연구실의 데이터 처리 규칙도 설치 전에 확인해야 합니다.
이 안내는 실험실의 주 작업 환경이 Linux나 Windows인 연구생과 박사과정 연구자, macOS용 FSL 환경을 관리하는 연구실 기술 담당자를 위한 내용입니다.
개인 Mac 없이 프로젝트를 점검하려는 경우에도 원격 macOS 환경을 검토할 때 필요한 기준을 확인할 수 있습니다.
설치 전에 장비와 프로젝트 조건을 구분합니다
FSL 공식 macOS 설치 문서는 최근 macOS에서 Intel과 Apple Silicon을 지원한다고 안내합니다. 단, 이 안내를 특정 macOS 소버전이나 연구실의 모든 플러그인과 의존성에 대한 보증으로 확대해서 해석하면 안 됩니다. FSL 6.0.7.23은 공식 버전 기록에 2026년 7월 28일 공개된 것으로 표시되어 있습니다. macOS 설치 안내와 FSL 버전 기록을 설치 전 기준으로 확인하세요.
먼저 Mac이 Apple Silicon인지, 프로젝트에서 실제로 필요한 FSL 도구가 무엇인지, 그래픽 화면이 필요한지를 적어 두세요. 기존 FSL 설치가 있다면 설치 경로와 셸 설정도 기록합니다. 이전 환경을 덮어쓴 뒤 문제가 생기면 새 설치 문제인지 기존 설정과의 충돌인지 판별하기 어려워집니다.
| 선택지 | 맞는 조건 | 먼저 확인할 점 | 실무 적합도 |
|---|---|---|---|
| Apple Silicon Mac에 설치 | Mac을 사용할 수 있고 macOS에서 직접 시험해야 하는 경우 | FSL 공식 지원 안내, 기존 환경 변수, 필요한 도구와 GUI | 우선 검토 |
| 원격 macOS 환경 | 개인 Mac이 없고 macOS 동작 확인이 필요한 경우 | 기관의 데이터 승인, 파일 전송과 접속 방식, 프로젝트 의존성 | 조건부 검토 |
| 연구실 Linux 또는 HPC | 분석이 Linux 환경을 기준으로 구축된 경우 | macOS 전용 기능을 검증할 수 있는지, 결과 비교 기준이 있는지 | Linux 작업에 적합 |
설치 위치와 셸 설정은 개인별 환경에 따라 달라질 수 있습니다. 공식 시스템 설정 안내를 읽고, 파일 시스템이나 기존 설정이 필요한 실행 방식과 충돌하지 않는지 확인하세요. 연구 자료 대신 되돌릴 수 있는 비민감 샘플을 준비하면 초기 확인 과정에서 원본 데이터를 건드릴 위험을 줄일 수 있습니다.
getfsl.sh로 공식 설치를 진행합니다
새 사용자는 FSL의 공식 macOS 설치 안내에 나온 getfsl.sh 절차를 우선 따르는 편이 안전합니다. 설치 명령은 바뀔 수 있으므로 오래된 블로그나 복사해 둔 명령을 그대로 실행하지 말고, 설치 시점의 공식 안내에서 현재 지시를 확인하세요.
진행 순서는 다음과 같습니다.
- 현재 사용 중인 셸과 FSL 관련 환경 변수를 기록합니다. 기존 FSLDIR 설정이 있다면 값과 설정 파일 위치도 남겨 둡니다.
- 공식 설치 문서의 시스템 조건과 설치 지침을 확인합니다. Mac의 아키텍처와 필요한 구성 요소가 프로젝트 조건에 맞는지 대조합니다.
- 공식 페이지에 안내된 getfsl.sh 실행 방법을 그대로 적용합니다. 실행 전후의 터미널 출력과 오류 메시지를 보관합니다.
- 설치가 끝난 뒤 출력 내용을 읽고, 설치 경로와 셸 초기화 안내를 확인합니다. 완료 문구만 보고 모든 도구가 정상이라고 판단하지 않습니다.
- 터미널을 새로 열어 환경을 다시 불러옵니다. 기존 터미널에서만 동작하는지, 새 셸에서도 동작하는지 구분해 확인합니다.
설치 과정에서 네트워크 오류나 권한 문제가 발생하면 명령을 무작정 반복하기보다 오류 지점과 셸 설정을 먼저 기록하세요. 이미 사용하던 FSL을 유지해야 한다면 새 설치 경로와 기존 경로가 섞이지 않도록 공식 설정 문서의 안내와 대조합니다.
새 터미널에서 환경 변수와 명령줄을 확인합니다
첫 점검은 설치한 FSL 경로가 현재 셸에 반영됐는지 확인하는 일입니다. 새 터미널에서 echo "$FSLDIR"을 실행해 예상한 경로가 표시되는지 살펴보세요. 값이 비어 있거나 다른 설치 위치를 가리키면 명령줄 검사에 앞서 셸 초기화 설정과 FSL 공식 설정 안내를 확인합니다.
| 검증 층위 | 확인 방법 | 통과로 볼 수 있는 범위 | 아직 확인하지 못한 것 |
|---|---|---|---|
| 환경 변수 | echo "$FSLDIR"로 경로 확인 |
셸에서 FSL 경로가 설정됐는지 | 개별 도구와 분석 기능 |
| 명령줄 | command -v fslmaths 등으로 실행 경로 확인 |
명령을 셸에서 찾을 수 있는지 | 실제 입력 파일 처리 결과 |
| 파일 처리 | 비민감 샘플에 fslmaths 사용 |
기본 실행과 출력 파일 생성 여부 | 프로젝트 전체의 분석 타당성 |
| 그래픽 화면 | FSLeyes 실행 후 이미지 열기 | 화면 실행과 파일 표시 여부 | 연구 절차의 정확성 |
| 프로젝트 | 대표 입력과 기준 결과 비교 | 해당 프로젝트의 환경 적합성 | 다른 자료와 조건에 대한 일반화 |
이후 command -v fslmaths와 command -v imcp로 명령을 찾을 수 있는지 확인합니다. 도구가 검색되지 않으면 설치가 완전히 실패했다고 단정하기보다 현재 터미널이 셸 설정을 읽었는지, FSLDIR이 올바른지를 먼저 점검하세요. 각 도구의 목적과 동작은 FSL 유틸리티 안내에서 확인할 수 있습니다.
대표 파일이 준비되어 있다면 복사와 처리도 별도로 시험합니다. 예를 들어 샘플 이미지에 fslmaths를 적용하고 새 출력 파일이 생성되는지 확인할 수 있습니다. 분석 결과가 연구 목적에 맞는지는 이 기본 실행만으로 판정할 수 없으므로, 입력 파일과 실행 명령, 생성 파일을 함께 기록하세요.
FSLeyes와 다른 GUI는 명령줄과 따로 평가합니다
명령줄 도구가 동작해도 그래픽 화면이 정상이라는 뜻은 아닙니다. 반대로 FSLeyes가 열리지 않더라도 명령줄 분석이 모두 불가능하다고 곧바로 결론 내릴 수도 없습니다. FSL 공식 FSLeyes 안내를 따라 실행한 뒤, 화면이 열리는지와 대상 이미지가 읽히고 표시되는지를 나누어 확인하세요.
문제가 생기면 실행한 터미널, 표시된 오류, 사용한 이미지 형식과 열기 방법을 기록합니다. 명령줄은 되지만 화면만 실패한다면 GUI 실행 문제로 좁혀 점검할 수 있습니다. 반대로 화면이 열려도 파일이 정상적으로 해석되는지, 연구에서 필요한 시각화가 가능한지는 별도 확인이 필요합니다.
대표 프로젝트 사본으로 연구 환경을 인수 검수합니다
기본 명령과 GUI 점검을 마친 뒤에는 연구에서 허용된 사본으로 실제 프로젝트 조건을 시험합니다. 기관 정책에 따라 자료를 복사할 수 없다면 데이터를 옮기기 전에 책임자나 관리자의 승인을 받으세요. 민감한 연구 자료를 개인 장비나 원격 환경에 임의로 전송해서는 안 됩니다.
검수할 때는 프로젝트가 요구하는 FSL 도구와 입력 형식, 필요한 파일 읽기와 쓰기, 주요 출력이 기준 환경과 어떻게 다른지를 기록합니다. 기존 분석이 있다면 실행 명령과 전처리 조건을 맞춘 뒤 연구 방법에 따라 결과를 검토하세요. 설치와 파일 생성이 성공해도 연구 결과의 타당성이나 재현성이 자동으로 입증되는 것은 아닙니다.
| 검수 항목 | 기록할 내용 | 판단 기준 |
|---|---|---|
| 실행 환경 | macOS 조건, FSL 경로, 사용한 셸 | 기록을 바탕으로 같은 설정을 다시 구성할 수 있는지 |
| 분석 도구 | 프로젝트가 호출하는 명령과 옵션 | 필요한 명령이 오류 없이 실행되는지 |
| 파일 처리 | 입력 사본, 출력 파일, 오류 기록 | 파일이 의도한 위치에 생성되고 다시 읽히는지 |
| 시각 확인 | FSLeyes 실행과 이미지 표시 상태 | 연구자가 필요한 화면 확인을 수행할 수 있는지 |
| 연구 검토 | 프로젝트 기준과 결과 비교 기록 | 연구 방법에 따라 담당자가 결과를 승인할 수 있는지 |
Mac을 사용할 수 없으면 원격 환경을 후보로 검토할 수 있습니다. 다만 접속 가능 여부보다 기관 데이터 정책, 파일 이동 경로, 필요한 GUI와 도구가 실제로 작동하는지를 먼저 확인해야 합니다. 원격 사용 조건을 비교할 때는 VPSMAC 원격 Mac 환경 안내에서 제공 방식과 환경 정보를 확인하고, 필요한 조건이 맞는지 문의 전에 정리하세요.
자주 묻는 질문
Apple Silicon Mac에서 FSL 설치 파일을 따로 골라야 하나요?
별도 설치 파일을 임의로 찾기보다 FSL 공식 macOS 설치 안내를 먼저 확인하고, 거기에 나온 getfsl.sh 절차를 따르세요. 공식 문서는 최근 macOS의 Intel과 Apple Silicon 지원을 설명하지만, 이것이 특정 macOS 소버전이나 연구실의 모든 의존성이 검증됐다는 뜻은 아닙니다. 설치 전 필요한 FSL 도구와 프로젝트 조건을 확인하고, 설치 출력과 환경을 기록해 두면 문제를 비교하기 쉽습니다.
getfsl.sh가 실행을 마치면 FSL을 바로 쓸 수 있나요?
설치 스크립트가 끝났다는 사실만으로 모든 구성 요소가 준비됐다고 판단하지 마세요. 새 터미널에서 FSLDIR이 예상한 위치를 가리키는지 확인하고, fslmaths나 imcp 같은 명령을 찾을 수 있는지도 살펴야 합니다. 이어서 실제 입력 파일의 복사와 처리를 확인하세요. 명령 호출, GUI 실행, 프로젝트 분석은 서로 다른 검증 단계이므로 어느 한 단계의 성공으로 나머지까지 통과했다고 간주하지 않는 편이 안전합니다.
FSLeyes가 열리지 않으면 설치를 다시 해야 하나요?
먼저 같은 터미널에서 FSL 명령줄 도구가 동작하는지 확인해 GUI 문제와 설치 전체 문제를 나누세요. 다음으로 공식 설정 안내와 FSLeyes 문서를 참고해 셸 설정, 실행 출력, 오류 메시지를 살펴보세요. 이미지 표시가 문제라면 파일과 열기 방법도 기록합니다. 한 번 실행되지 않았다고 FSL 전체가 잘못 설치됐다고 단정하지 말고, 오류를 보존해 필요할 때 관리자에게 전달하세요.
개인 Mac 없이 원격 macOS에서 프로젝트를 시험해도 되나요?
원격 Mac은 macOS에서 필요한 도구와 GUI를 확인할 후보가 될 수 있습니다. 사용 전에 연구 데이터의 반출과 원격 처리에 관한 기관 승인, 프로젝트 의존성, 파일 전송 방식과 접속 방법을 확인하세요. 비민감한 프로젝트 사본으로 기본 동작을 시험한 뒤 대표 분석을 재현하는 편이 좋습니다. 기관 정책이 원격 처리를 허용하지 않거나 작업이 Linux HPC에 종속되어 있다면 연구실 관리자와 다른 검증 경로를 먼저 정하세요.
실험실의 Linux나 Windows 환경만으로는 macOS 전용 도구와 GUI를 직접 확인하기 어렵고, 의존성을 옮기는 과정에서 환경 차이가 생길 수 있습니다. 반면 Mac을 구매하면 연구 목적이 제한적일 때 장비 비용과 관리 부담이 남습니다. 우선 비민감한 사본으로 필요한 기능을 확인하고, 실제 Mac이 필요하지만 보유 장비가 없다면 VPSMAC의 원격 Mac 이용 안내를 살펴보세요. 이용 전에는 기관의 데이터 규칙과 필요한 macOS 조건, 접속 방식을 확인해야 하며, 장시간 지속 작업이나 물리 장비 연결이 핵심인 연구라면 원격 환경이 적합하지 않을 수 있습니다.
자주 묻는 질문
Apple Silicon Mac에서는 FSL 설치 파일을 따로 골라야 하나요?
별도 설치 파일을 임의로 찾기보다 FSL 공식 macOS 설치 안내를 먼저 확인하고, 안내된 getfsl.sh 경로를 따르세요. 공식 문서는 최근 macOS의 Intel과 Apple Silicon 지원을 설명하지만, 이것만으로 특정 macOS 소버전이나 연구실의 모든 의존성이 검증되는 것은 아닙니다. 설치 전 필요한 FSL 도구와 프로젝트 조건을 확인하고, 설치 출력과 사용한 환경을 기록해 두면 문제가 생겼을 때 비교하기 쉽습니다.
getfsl.sh가 끝까지 실행되면 FSL을 바로 사용할 수 있나요?
설치 스크립트가 종료되었다는 사실만으로 모든 구성 요소가 준비됐다고 판단하지 마세요. 새 터미널에서 FSLDIR이 예상한 설치 위치를 가리키는지 확인하고, fslmaths나 imcp 같은 명령이 실행 경로에서 검색되는지 점검해야 합니다. 그다음 실제 입력 파일의 복사와 처리까지 확인하세요. 명령 호출과 GUI 실행, 프로젝트 분석은 서로 다른 검증 단계이므로 하나의 성공을 나머지 단계의 통과로 간주하지 않는 편이 안전합니다.
Mac에서 FSLeyes가 열리지 않을 때는 무엇부터 확인해야 하나요?
먼저 같은 터미널에서 FSL 명령줄 도구가 실행되는지 확인해 GUI 문제와 설치 전체 문제를 분리하세요. 이어서 공식 설정 안내와 FSLeyes 문서에 따라 셸 설정, 실행 출력, 오류 메시지를 살펴보고, 이미지가 표시되지 않는 경우에는 사용한 파일과 열기 방법도 기록하세요. 한 번의 실행 실패만으로 FSL 전체가 설치되지 않았다고 단정하지 말고, 오류 내용을 보존해 필요한 경우 관리자에게 전달하세요.
개인 Mac이 없어도 원격 macOS에서 FSL 프로젝트를 검증할 수 있나요?
원격 Mac은 macOS에서 필요한 도구와 GUI를 확인할 후보가 될 수 있습니다. 다만 사용 전에 연구 데이터의 반출과 원격 처리에 관한 기관 승인, 프로젝트 의존성, 파일 전송 방식, 접속 방법을 먼저 확인해야 합니다. 비민감한 프로젝트 사본으로 명령줄과 FSLeyes를 시험한 뒤 대표 분석을 재현해 보세요. 기관 정책상 원격 처리가 허용되지 않거나 워크플로가 Linux HPC에 종속되어 있다면 연구실 관리자와 대체 검증 경로를 정하는 것이 우선입니다.