# 更新包索引
sudo apt-get update

# 安装 Memcached 和开发库
sudo apt-get install -y memcached libmemcached-tools

# 验证安装
memcached -h | head -5
# memcached 1.6.x

# 查看服务状态
sudo systemctl status memcached

# 启动并设置开机自启
sudo systemctl start memcached
sudo systemctl enable memcached

# 查看默认配置
cat /etc/memcached.conf

# /etc/memcached.conf
-d              # 以守护进程运行
logfile /var/log/memcached.log
-m 64           # 最大内存 64MB
-p 11211        # 监听端口
-u memcache     # 运行用户
-l 127.0.0.1    # 只监听本地（安全）
-c 1024         # 最大连接数
-t 4            # 工作线程数

# CentOS 7 / RHEL 7
sudo yum install -y memcached

# CentOS 8+ / RHEL 8+ / Fedora
sudo dnf install -y memcached

# 启动服务
sudo systemctl start memcached
sudo systemctl enable memcached

# 检查防火墙（如果需要远程访问）
sudo firewall-cmd --add-port=11211/tcp --permanent
sudo firewall-cmd --reload

# 安装依赖
sudo apt-get install -y build-essential libevent-dev

# 下载源码（以 1.6.31 为例）
cd /tmp
wget https://memcached.org/files/memcached-1.6.31.tar.gz
tar xzf memcached-1.6.31.tar.gz
cd memcached-1.6.31

# 配置编译选项
./configure \
    --prefix=/usr/local/memcached \
    --enable-sasl           \  # 启用 SASL 认证
    --enable-tls            \  # 启用 TLS 加密
    --enable-seccomp           # 启用 seccomp 沙箱

# 编译（-j 指定并行数）
make -j$(nproc)

# 安装
sudo make install

# 验证
/usr/local/memcached/bin/memcached -h

# 使用 Homebrew
brew install memcached

# 查看安装信息
brew info memcached

# 启动服务（后台）
brew services start memcached

# 或者前台运行（开发调试用）
memcached -vv -p 11211

# 验证
nc localhost 11211
version
# VERSION 1.6.x
quit

# 拉取镜像
docker pull memcached:1.6-alpine

# 启动容器
docker run -d \
    --name memcached \
    -p 11211:11211 \
    memcached:1.6-alpine \
    memcached -m 128 -c 2048 -t 4

# 验证运行
docker stats memcached --no-stream
docker exec memcached memcached --version

# 开发环境：带详细日志
docker run -d --name mc-dev -p 11211:11211 \
    memcached:1.6-alpine \
    memcached -m 64 -vv

# 生产环境：资源限制
docker run -d --name mc-prod -p 11211:11211 \
    --memory=2g \
    --cpus=2 \
    --restart=unless-stopped \
    --ulimit nofile=65535:65535 \
    memcached:1.6-alpine \
    memcached -m 1024 -c 10000 -t 8

# 带 SASL 认证
docker run -d --name mc-sasl -p 11211:11211 \
    memcached:1.6-alpine \
    memcached -m 128 -S

memcached -h

# 常用扩展选项组合
memcached -o \
    maxconns_fast,      # 快速拒绝超限连接
    lru_crawler,        # 启用 LRU 爬虫
    lru_maintainer,     # 启用 LRU 维护线程
    hash_algorithm=murmur3,  # 哈希算法
    slab_automove=1,    # 自动 Slab 迁移
    no_hashexpand       # 禁止哈希表扩展

memcached \
    -m 64 \
    -p 11211 \
    -l 127.0.0.1 \
    -c 256 \
    -t 2 \
    -vv

memcached \
    -m 256 \
    -p 11211 \
    -l 0.0.0.0 \
    -c 1024 \
    -t 4 \
    -f 1.25 \
    -o lru_maintainer,slab_automove,maxconns_fast

memcached \
    -m 4096 \
    -p 11211 \
    -l 10.0.1.10 \
    -c 65535 \
    -t 8 \
    -f 1.25 \
    -n 72 \
    -k \
    -o lru_maintainer,slab_automove,maxconns_fast,hash_algorithm=murmur3 \
    -R 20 \
    -u memcache \
    -P /var/run/memcached/memcached.pid

# /etc/systemd/system/memcached.service
[Unit]
Description=Memcached Server
After=network.target

[Service]
Type=simple
User=memcache
Group=memcache
ExecStart=/usr/bin/memcached \
    -m 4096 \
    -p 11211 \
    -l 10.0.1.10 \
    -c 65535 \
    -t 8 \
    -k \
    -o lru_maintainer,slab_automove,maxconns_fast
ExecReload=/bin/kill -USR1 $MAINPID
LimitNOFILE=65535
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

# 生效并启动
sudo systemctl daemon-reload
sudo systemctl restart memcached
sudo systemctl status memcached

# 方法一：使用 nc（netcat）
echo "version" | nc localhost 11211
# VERSION 1.6.31

# 方法二：使用 telnet
telnet localhost 11211
# version
# VERSION 1.6.31
# quit

# 方法三：使用 Python
python3 -c "
import socket
s = socket.socket()
s.connect(('localhost', 11211))
s.send(b'version\r\n')
print(s.recv(1024).decode())
s.close()
"

# 通过 nc 执行基本读写
{
    echo "set testkey 0 60 5"
    echo "hello"
    echo "get testkey"
    echo "quit"
} | nc localhost 11211

# 预期输出：
# STORED
# VALUE testkey 0 5
# hello
# END

# 查看进程
ps aux | grep memcached

# 查看监听端口
ss -tlnp | grep 11211

# 查看内存使用
echo "stats" | nc localhost 11211 | grep -E "bytes |curr_items|cmd_get|cmd_set|get_hits|get_misses"

# 查看连接数
echo "stats" | nc localhost 11211 | grep curr_connections

# 错误：bind(): Address already in use
# 原因：端口被占用
sudo lsof -i :11211
sudo kill -9 <PID>

# 错误：mlockall(): Cannot allocate memory
# 原因：内存锁定失败，ulimit 限制
sudo sh -c "echo 'memcache hard memlock unlimited' >> /etc/security/limits.conf"
sudo sh -c "echo 'memcache soft memlock unlimited' >> /etc/security/limits.conf"

# 错误：too many connections
# 原因：连接数超过 -c 限制
# 解决：增大 -c 参数或检查连接泄漏

# 检查系统可用内存
free -h

# 检查 Memcached 实际使用
echo "stats" | nc localhost 11211 | grep -E "bytes |limit_maxbytes"