Applicable Products
QTS 5.2.0 and above, QuTS hero 5.2.0 and above
Root Cause
When performing certain file actions on a symbolic link (for example copy, move, download, compress), the system will check that you have sufficient permissions to perform the action on both the symbolic link and on the file/folder the symbolic link is pointing to. If you do not have sufficient permissions on either the symbolic link or the linked file/folder, you will not be able to perform the action. You might also receive a "permission denied" error message.
What is a symbolic link?
- A symbolic link is a special type of file that references another file or folder.
- Symbolic links are similar to shortcuts on other operating systems, they allow you to create multiple file paths that link to a single file or folder without the need to physically copy the file or folder.
- Symbolic links are an advanced feature of QNAP operating systems and can only be created via SSH.
Determining permissions for symbolic links
To perform a particular file action (open,edit, copy,compress,etc.) on a symbolic link, the following are required:
- The file/folder linked to by the symbolic link must be a valid file path. Additionally, the following paths are also valid paths for targets of symbolic links:
- Paths listed in /etc/config/smb.conf under the section "PATH"
- Paths defined by Ubuntu Linux Station
- Paths defined by Snapshot and Snapshot Vault
- Paths of remote mounts
- /share/external/.nd
- /share/external/.cm
- /share/external/.cr
- You must have sufficient permission to perform the same file action on the linked file/folder.
For example, if a symbolic link references the file "myfile.doc", and you do not have write permission on "myfile.doc", then you do not have write permission on the symbolic link.
Example Scenario
The following is an example scenario where a file action on a symbolic link may be denied because the user does not have sufficient permissions on the linked file/folder.
The application Plex Media Server creates and uses symbolic links as part of its normal operation. If you create a shard folder on your system and restart Plex Media Server, then Plex Media Server will automatically create the symbolic folder link "Plex Media Server" in your shared folder. If you try to compress this symbolic link in File Station, you will receive the error "Unable to perform this action. You do not have enough permissions, or this folder is read-only". In this case, you cannot compress the symbolic folder link "Plex Media Server" because you do not have permission to compress the folder that "Plex Media Server" links to.
적용 가능한 제품
QTS 5.2.0 이상, QuTS hero 5.2.0 이상
근본 원인
심볼릭 링크에서 특정 파일 작업(예: 복사, 이동, 다운로드, 압축)을 수행할 때, 시스템은 심볼릭 링크와 심볼릭 링크가 가리키는 파일/폴더 모두에 대해 충분한 권한이 있는지 확인합니다. 심볼릭 링크나 연결된 파일/폴더 중 하나라도 충분한 권한이 없으면 작업을 수행할 수 없습니다. 또한 "권한 거부" 오류 메시지를 받을 수 있습니다.
심볼릭 링크란 무엇인가요?
- 심볼릭 링크는 다른 파일이나 폴더를 참조하는 특수한 유형의 파일입니다.
- 심볼릭 링크는 다른 운영 체제의 바로 가기와 유사하며, 파일이나 폴더를 물리적으로 복사할 필요 없이 단일 파일이나 폴더에 연결되는 여러 파일 경로를 만들 수 있게 해줍니다.
- 심볼릭 링크는 QNAP 운영 체제의 고급 기능이며 SSH를 통해서만 생성할 수 있습니다.
심볼릭 링크의 권한 결정
심볼릭 링크에서 특정 파일 작업(열기, 편집, 복사, 압축 등)을 수행하려면 다음이 필요합니다:
- 심볼릭 링크가 가리키는 파일/폴더는 유효한 파일 경로여야 합니다. 추가로, 다음 경로도 심볼릭 링크 대상의 유효한 경로입니다:
- /etc/config/smb.conf의 "PATH" 섹션에 나열된 경로
- Ubuntu Linux Station 에 의해 정의된 경로
- 스냅샷및스냅샷Vault에 의해 정의된 경로
- 원격 마운트의 경로
- /share/external/.nd
- /share/external/.cm
- /share/external/.cr
- 연결된 파일/폴더에서 동일한 파일 작업을 수행할 수 있는 충분한 권한이 있어야 합니다.
예를 들어, 심볼릭 링크가 "myfile.doc" 파일을 참조하고 있고, "myfile.doc"에 쓰기 권한이 없다면, 심볼릭 링크에도 쓰기 권한이 없습니다.
예제 시나리오
다음은 사용자가 연결된 파일/폴더에 충분한 권한이 없어서 심볼릭 링크에서 파일 작업이 거부될 수 있는 예제 시나리오입니다.
애플리케이션 Plex Media Server는 정상적인 작동의 일환으로 심볼릭 링크를 생성하고 사용합니다. 시스템에 공유 폴더를 생성하고 Plex Media Server를 다시 시작하면, Plex Media Server는 자동으로 공유 폴더에 "Plex Media Server"라는 심볼릭 폴더 링크를 생성합니다. File Station 에서 이 심볼릭 링크를 압축하려고 하면 "이 작업을 수행할 수 없습니다. 권한이 부족하거나 이 폴더는 읽기 전용입니다"라는 오류가 발생합니다. 이 경우, "Plex Media Server"가 링크된 폴더를 압축할 권한이 없기 때문에 "Plex Media Server" 심볼릭 폴더 링크를 압축할 수 없습니다.