dosyaのSFTP接続や転送の問題を解決する

問題が認証前、ワークスペースの一覧表示中、バイト転送中、サーバーによるファイルのクローズ時のどこで発生したかを確認してください。dosyaは閉じるでSFTPアップロードを確定するため、クライアントの進行状況が100%になってもクラウドファイルが受け付けられた証拠にはなりません。

手順

設定	dosyaの値
プロトコル	SFTP / SSH File Transfer Protocol
ホスト	sftp.dosya.dev
ポート	2222
ユーザー名	APIキーのオーナーのアカウントのメールアドレス。大文字と小文字も一致させます
認証	パスワード
パスワード	完全なdos_… APIキー
開始フォルダー	/

ゲートウェイはdosyaアカウントのパスワード、OAuth/MCPトークン、SSH公開鍵、FTP、FTPSを受け付けません。対話型シェルも提供しません。OpenSSHでは大文字の-P 2222でポートを指定します。小文字の-pは別の意味です。

プロフィール → API（APIキー）で専用キーを作成してください。SFTPを許可し、制限する場合はアクセス可能なワークスペースに固定します。一覧表示とダウンロードにはRead only、書き込みが必要な場合はフルアクセスを使用してください。アップロードのみキーでは、ほとんどのSFTPクライアントに必要な一覧表示ができません。このゲートウェイはフォルダーアンカー付きキーとIP許可制限を拒否します。代わりにワークスペースに固定してください。有効期限、利用可能時間、明示的な使用制限は引き続き適用されます。

ホストの識別情報をパスワードと別に確認する

初回接続時は、ホスト名、ポート、鍵の種類、フィンガープリントを、別の連絡経路でdosyaサポートまたは管理者から入手した信頼できる値と比較してください。このガイドには認証済みの本番環境のフィンガープリントを掲載していません。

クライアントに**REMOTE HOST IDENTIFICATION HAS CHANGED!**と表示された場合は停止してください。known_hostsを変更する前に、正当な鍵のローテーションであることを確認します。APIキーの置換ではホスト鍵の不一致は解決せず、ホスト鍵の確認を無効にすると警告による保護が失われます。

認証の問題を解決する

正確なメールアドレス、完全なキー、SFTPプロトコルの選択、ワークスペースへの固定、有効期限を確認してください。追跡期間内に同じ送信元アドレスからパスワードを5回間違えると、そのアドレスが15分間禁止される場合があります。推測をやめ、認証情報を修正して禁止の期限が切れてから1回再試行してください。

サーバーは標準で30秒後に未認証の接続を切断します。一時的なAPI検証の問題は誤ったパスワードとしてカウントされません。正常とわかっているキーをすぐに更新せず、クライアントの時刻を記録して1回再試行してください。

SFTPのサインイン成功とロール権限のキャッシュはそれぞれ最大60秒間保持されます。API認可には別のキャッシュがあるため、この期間は失効完了までの上限を保証しません。キーの失効やロールの変更後、無効化が反映されてから新しい接続と無害な操作で拒否されることを確認してください。すでに開いているチャネルがあっても、その後の操作を確定できるとは限りません。

パスと権限のメッセージを確認する

• このロールではSFTPを使用できませんは現在のワークスペースのロールにaccess_sftpがないことを意味します。オーナーまたは管理者にロールの変更を依頼してください。
• access to that workspace is not permitted for this credential（ステータス3）は、メンバーシップ、ワークスペースへの固定、またはロールのアクセスがそのパスを対象にしていないことを示します。
• no such file or directory（ステータス2）は、一覧にある名前の誤入力や、この認証情報から見えない対象を意味する場合があります。/からやり直し、そこで返されたワークスペース名またはスラッグを使用してください。
• the parent directory does not exist or is not writable by this credentialが表示された場合、既存の移動先と作成またはアップロード権限が必要です。
• this server supports open for reading or writing, not append or read-writeは、クライアントがサポートされない追記または再開モードを選択したことを意味します。

ルートには許可されたワークスペースが一覧表示されます。WebDAVのすべてコレクションはありません。ワークスペース自体はSFTPから作成できません。chmodとchownのリクエストは受け付けられますが、dosyaの権限は変更されません。シンボリックリンクには対応していません。

アップロードの完了を確認する

現在デプロイされているSFTPアップロードの上限はファイルあたり**352 MiB（369,098,752バイト）**です。環境によっては、より小さい有効値が表示される場合があります。ワークスペースのファイルポリシー、利用可能なクラウドストレージ、キーやロールの制限により、より小さなファイルも拒否されることがあります。

転送結果	対処
write past the 352 MB per-file limit（または表示された別の値）	ファイル全体に適したdosyaのアップロード方法を使用してください。別のオフセットへの書き込みでは上限を回避できません。
close failed: API 403 …	添付された権限やポリシーの理由を確認してください。WRITEの成功だけではクラウドへの確定は行われません。
close failed: API 429 (rate limited - back off and retry) …	並列転送を停止して待ち、該当する使用枠または空きができてからファイル全体を再試行してください。
access to this workspace was revoked while the upload was in flight	許可されたメンバーシップやロールを復元するか、別の許可された移動先を選択してください。部分ハンドルは再開しないでください。
一般的なSSH_FX_FAILURE	操作と、必要な範囲に絞ったサーバーメッセージを記録してください。APIの403は権限拒否、404はファイルなし、それ以外の問題はステータス4に対応します。

アップロードはSFTPセッション中にバッファーされ、クローズ時に確定されます。現在、空のアップロードではファイルは作成されません。中断した書き込みはサーバー側で永続的に再開できません。再開、Append、reput、put -aは使用しないでください。開き直しても以前の先頭部分は読み込まれないため、できれば新しいテスト名を使い、オフセット0からやり直してください。

既存のパスを置き換えると、dosyaのファイルにバージョンが追加され、現在のバイトデータが変わる場合があります。rmとフォルダーの削除は対象のコンテンツをゴミ箱に移動し、関連する共有リンクを無効化します。ゴミ箱の保持期間は無料プランのオーナーでは7日、その他のプランでは30日です。完全な消去は元に戻せません。

期待される結果

1. 接続し、/でpwdとlsを実行します。
2. サーバーが返したワークスペース名に入り、既存のフォルダーを一覧表示します。
3. 内容がわかっている無害なファイルをダウンロードし、ローカルでバイトデータを比較します。
4. 許可されている場合、空ではない一意の名前のサンプルを1件アップロードし、最終クローズの結果を待ちます。
5. dosyaのファイルを更新し、名前と容量を比較してから、クラウドコピーをダウンロードしてSHA-256を確認します。

別のプロトコルで行われたフォルダーの変更は、設定されたフォルダーキャッシュの期限が切れるまで反映が遅れる場合があります。標準は10秒です。表示が古いと報告する前に、該当する時間を待って一覧を更新してください。

サポートへの連絡には、クライアントとバージョン、ホストとポート、操作、非公開の名前を伏せたワークスペースとパス、ステータスとメッセージ、ファイル容量、時刻とタイムゾーン、サインイン、WRITE、CLOSEのどこで問題が発生したかを含めてください。APIキー、パスワード入力画面の内容、非公開ファイルのバイトデータは添付しないでください。

関連ガイド

• SFTPで接続する
• キーを失効させる