接続の問題

リモートファイルシステムとバックアップの接続に関するトラブルシューティング

リモートファイルシステム接続エラー

症状:

Error: FTP connection timeout
Error: SFTP connection failed: dial tcp: i/o timeout

確認すべき点:

ホスト名とポートが正しいか:

# FTP
lightfile-batch ftp --ftp-host ftp.example.com --ftp-port 21 ...

# SFTP
lightfile-batch sftp --sftp-host sftp.example.com --sftp-port 22 ...

ファイアウォール設定を確認
タイムアウト時間を延長:
```
lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-short-timeout 60 \
  --ftp-long-timeout 600 \
  ...
```
注意: タイムアウト時間は秒単位で指定します（--ftp-short-timeoutは高速操作用、--ftp-long-timeoutはファイル転送用）

接続テスト:

# FTP
ftp ftp.example.com

# SFTP
sftp user@sftp.example.com

症状:

Error: FTP authentication failed: 530 Login authentication failed

対処法:

認証情報を再確認:

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user correct_username \
  --ftp-password correct_password

YAML設定ファイルで指定:

ftp:
  host: ftp.example.com
  user: your_username
  password: your_password

症状:

Error: SFTP authentication failed: ssh: unable to authenticate
Error: failed to parse private key

対処法:

秘密鍵ファイルのパスを確認:

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-private-key ~/.ssh/id_rsa

パスワード認証を試す:

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-password mypassword

症状:

Error: Amazon S3 credentials not found.
Error: S3 operation failed: The AWS Access Key Id you provided does not exist in our records

対処法:

エラーメッセージに表示される5つの設定方法を確認してください。最も一般的な解決方法:

環境変数が正しく設定されているか確認:
```
echo $AWS_ACCESS_KEY_ID
echo $AWS_SECRET_ACCESS_KEY
```

AWS CLIの設定を確認:

aws configure list
cat ~/.aws/credentials

症状:

Error: S3 operation failed: NoSuchBucket: The specified bucket does not exist

よくある原因:

バケット名とリージョンを確認:

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region us-west-2 \
  --s3-acl private

症状:

Error: WebDAV operation failed: 401 Unauthorized

対処法: ユーザー名とパスワードを再確認してください

lightfile-batch webdav \
  --webdav-url https://webdav.example.com/dav/ \
  --webdav-user your_username \
  --webdav-password your_password

症状:

Error: backup failed: permission denied

対処法:

書き込み権限を付与:

chmod u+w ~/.lightfile-next/batch/project/backup

別のディレクトリを指定:

lightfile-batch local /path/to/images --backup-dir /tmp/backup

症状:

Error: backup failed: not enough free space

対処法:

古いバックアップを削除:

rm -rf ~/.lightfile-next/batch/*/backup/*

バックアップモードを変更:

# バックアップを無効化
lightfile-batch local /path/to/images --backup-mode none

# バックアップ失敗を許容
lightfile-batch local /path/to/images --backup-mode loose

別のディスクを使用:

lightfile-batch local /path/to/images --backup-dir /mnt/external/backup